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TURBO C 

Borland’s No-Nonsense License Statement! 

This software is protected by both United States copyright law and international treaty provisions. 
Therefore, you must treat this software just like a book, with the following single exception. Borland 
International authorizes you to make archival copies of the software for the sole purpose of backing- 
up our software and protecting your investment from loss. 

By saying, "just like a book,’ Borland means, for example, that this software maybe used by any number 
of people and may be freely moved from one computer location to another, so long as there is no 
possibility of it being used at one location while it’s being used at another. Just like a book that can't 
be read by two different people in two different places at the same time, neither can the software be 
used by two different people in two different places at the same time (unless, of course, Borland’s 
copyright has been violated). 

Programs that you write and compile using the Turbo C language compiler may be used, given away 
or sold without additional license or fees, as long as all copies of such programs bear a copyright notice. 
By "copyright notice" we mean either your own copyright notice or, if you prefer, the statement, 
"Created using Turbo C # Copyright ® Borland 1987, 1988" Included in the Turbo C diskettes are several 
support files that contain encoded hardware and font information used by the standard graphics library 
(GRAPHICS.LIB). These files, which can be listed by typing DIR *.CHR and DIR are proprietary 
to Borland International. You may use these files with the programs you create with Turbo C for your 
own personal use. In addition, to the extent the programs you write and compile using the Turbo C 
language compiler make use of these support files, you may distribute these support files in combination 
with such programs, provided that you do not use, give away, or sell the support files separately, and 
all copies of such programs bear a copyright notice. 

The sample programs included on the Turbo C diskettes provide a demonstration of how to use the 
various features of Turbo C. They are intended for educational purposes only. Borland International 
grants you (the registered owner of Turbo C) the right to edit or modify these sample programs for 
your own use, but you may not give away or sell them, alone or as part of any program, in executable, 
object or source code form. You may, however, incorporate miscellaneous sample program routines into 
your programs, as long as your resulting programs do not substantially duplicate all or part of a sample 
program in appearance or functionality and all copies of such programs bear a copyright notice. 

Limited Warranty 

With respect to the physical diskette and physical documentation enclosed herein, Borland 
International, Inc. ("Borland") warrants the same to be free of defects in materials and workmanship for 
a period of 60 days from the date of purchase. In the event of notification within the warranty period 
of defects in material or workmanship, Borland will replace the defective diskette or documentation. If 
you need to return a product, call the Borland Customer Service Department to obtain a return 
authorization numben The remedy for breach of this warranty shall be limited to replacement and shall 
not encompass any other damages, including but not limited to loss of profit, and special, incidental, 
consequential, or other similar claims. 

Borland International, Inc. specifically disclaims all other warranties, expressed or implied, including 
but not limited to implied warranties of merchantability and fitness for a particular purpose with 
respect to defects in the diskette and documentation, and the program license granted herein in 
particular, and without limiting operation of the program license with respect to any particular 
application, use, or purpose. In no event shall Borland be liable for any loss of profit or any other 
commercial damage, including but not limited to special, incidental, consequential or other damages. 

Governing Law 

This statement shall be construed, interpreted, and governed by the laws of the state of California. Use, 
duplication, or disclosure by the U.S. Government of the computer software and documentation in this 
package shall be subject to the restricted rights under DFARS 52.227 -7013 applicable to commercial 
computer software. 





専門プログラマのための Turbo C 2.0 ランタイム • ライブラリ•ソースコード 


TurboC ランタイム.ライブラリ.ソースコードによって、皆さんは、 ft 初から浮門家として活掙できます。このソースコードによ 
り、皆さんは TurboC についての理解を深めることができ、また、コンハ•イラ•ルーチンおよびファンクシヨン内部の仕組みについて 
詳しく知ることができますから、皆さんのブログラム環境のよ0良い管理が可能となります。 


Turbo C ランタイム•ライブラリによって、300ファンクション以上のライブラりをカスタマイズすることができ、また、ルーナンを 
追加•変史できます 0 したがって、»さんのブログラムの具体的ニーズが、 TurboC ランタイム•ライブラリと兴なる場合にも対処す 
ることができます。また、厳密にコード化および最適化された TurboC ライブラリのルーチンを利用することができ、しかも、それが 
前提としている事枘に制限されることはありません。 

コンパイラ会社には、ライブラリ.ソースコードを提供しないところもあり、その代金として数千ドル t 請求する会社もあります0 
その結采、多くの作•門家は、ライブラリ•ルーチンの動きについて十分理解するために、やむなく数千時間も货やして.自分自身のライ 
ブラリを冉かねばなりません。ボーランドではその手間を咨いて、マイクロ • コンピュータの联史において最も人気のあるコンハ•イラ 
のソースコードを、わずか29.800円で皆さんにご利用いただこうというわけです。 

今すぐ Turbo C ランタイム•ライブラリ•ソースコードをご注文ください 0 注文寄にご記人後 — TurboC ランタイム•ライブラリ • 
ソースコード注文 J と表害きの上、下記までお送 1 ) ください。 

また、ご入金も下3己の口座までお肫いいたします。 


-代理店- 

侏式会社マイクロソフトウユアアソシエイツ（略称 MSA ) 
〒107東京都港区南靑山 7-8 — 1小田免南靑山ビル9 F 
TEL 03-486-1411 / FAX 03-486 8905 


お振込先：東海銀行九段支店当座710 3 5 7 


【注意 】 Rifri に必费參 m をご記人後、切り取らずにこのままご返送ください。控えが必要な方はコビーをお取り下さい。 


Turbo C 2.0 ランタイム • ライブラリ • ソースコード 注文書 
Turbo C シリアルナンバー メディア•サイズ 


▽個人で咙人された方のみご記入ください。 

お名前 

▽会社で睬入された方のみご記入ください 0 

お会社名 




■ 



ご所* 



ご徂当（お名前） 



TEL 



お支払方法（該当するものに V をつけてください） 

□銀行振込（振込日 年 n 日：□文 冉□電 價） 

□現金赛留 

□その他 （ ） 

*本契約 辨兼 注文齊の受領、および代金お支払の確这後1ヶ月以内に商品発送となります。 

Turbo C 2.0 ランタイム • ライブラリ • ソースコード契約害 

TurboC ランタイム.ライブラリ.ソースコード実施契約についてボーランドはまたとない機会を提供します 

ボーランドでは、今一度、絶好の機会を皆さんに提供いたします。 g 験の深い C ブログラマとして、皆さんは TurboC ランタイム • 
ライブラリ.ソースコードの取扱いがいかに M 要であるかをご存知です。当社では、 TurboC ランタイム.ライブラリ.ソースコード 
を、たった29.800円で、日本の TurboC ユーザーの皆さんに提供いたします。 

これは、皆さんがコードをよりよく理解し、 TurboC ブログラムの性能を最大限に活かすまたとない機会です。 

今すぐ TurboC ランタイム.ライブラリ.ソースコードをご注文下さい。極めて 貴® で信傾性の商い TurboC ランタイム.ライブ 
ラリ•ソースコードを利用するために、どうぞこのページの注文書にご記入の上、代理店宛にお申し込み下さい。 









Turbo C 2.0 ランタイム • ライブラリ • ソースコード/ボーランドの実用的な実施契約 


ボーランド•インターナショナル（以下「ボーランド」）は、 TurboC の中に含まれる TurboC ライブラリの部分のソースコード（以 
下「ソース•ブログラム」>、および、別料金にて、後日ボーランドが提供する 更新 データ（ただし8087エミュレータとグラフィックス • 
ライブラリのソースコードは含•まれません）の実施契約の 募集を 行っております。 

このソース • ブログラムは、米国著作権法および国際条約によって保通されておりますので、下記の唯一の例外事項を除いて 卉 格と 
向梂の取扱いが必要です。许さんは皆さんのブログラムの バッ クアップのため、それから许さんの支出について損されないためにのみ、 
ソース.ブログラムの保存用コピーを作成することができます。 

广卉拚と同様に」とは、たとえば、ソース•ブログラムの使用者数に制限を設けず、褀数のコンピュータ•ワークステーションで向 
時に使用される可能性がない限り、ソース.ブログラムはその間を自由に移動することができるという意味です。 * 箝が同時にニケ所 
で二人の人間によって狁まれるのが不可能であるのと问搽に、ソース.ブログラムも、問時にニケ所の輿なった楊所で二人の輿なった 
人間によって使用することはできません ◊ (もちろんボーランドの著作梅を俊*すれば別です。）この制限付保証は、しかし、钎さん0 
身によるソース•ブログラムの変更に起因した欠陥には適用されません。 

ソース•ブログラムは、 TurboC の突施許婼コビーをサポートするために使用できます。これはどういうことかと申しますと、ソー 
ス•ブログラムを侍さん自身が開免する TurboC ベースのブログラムのコビーに含めることができるということですが、それは実行可 
能な形式においてのみ、それらを fid 付できるという意味です。実際の TurboC ランタイム•ライブラリ.ソースコードのいかなる部分 
も配付できません。もちろん、许さん自身のソースコードの配付は制限されません。 

钎さんはソース•ブログラムを変史することはできますが、変史されたソースコードの所有惟は、その変史の程度とは無関係に、ボ 
ーランドに«します。皆さんはボーランドの著作権、その他の財®榷に閱する表示を除去したり変史したりすることはできません。ま 
た、変史の程度とは無関係に、ソース•ブログラムのいかなる部分も紀付できず、他のコンピュータのオペレーティング•システムま 
たは環境に移すことはできません。许さんは、佐さん自身によるソース•ブログラムの変史、およびそのブログラムを含む製品に起 W 
するすべての請求、資任および損#について貴任を ft わねばなりません❶ 

この灾施拖によって明示的に付与されていない惟利は、すべてボーランドが留保します。 

制限付保証 

実際のディスケットおよびドキュメンテーションについては、ボーランドはその丰オ料およひ•その仕上に欠陥がないことを保証します 0 
これは、 W 人後60日間の限定丨发証です。ボーランドが、この60日以内に、 M 料またはその仕上の欠陥について文齊による通知を受けた 
場合には、そのディスケットまたはドキュメンテーションを交換いたします，诗さんが製品を返却したいと思う場合には、返却許可番 
号の決定手統きのために、代理店まで連絡してください0 

また、ボーランドおよび代理店は、ソース•ブログラムの使用に関し、技術的な援助は提供しません。 

この制限付保址の遍反に対する敉済手段は、ディスケットおよびドキュメンテーションの代枰に限定され、その他の賠償は含ま 
れません。ボーランドは、たとえ当方の代理店がそのような找害の可能性についてあらかじめ通知されていても、利益の州失、または 
その他の商窠上の Itt 害を含む問接拟害、特別 II (害、その他の頌似の捎兴または請求について寅任を ft いません。また、いかなる場合に 
も、 W さんまたはその他の者の撗害に対するボーランドの貴任は、 讲 求の形式を問わず、ソース•ブログラム灾施褓について支払われ 
る代価を超えるものではありません。 

ボーランドは、その他のいかなる明示または黙示の保钲も行いません。 H 体的には、ボーランドは、ソース•ブログラムが特定の用 
途に対して適合することを保証するものではありません。商« 価侦 に対する保証は、60日の保証期間に限って実際のディスケットおよ 
びドキュメンテーシ 3 ン（ソース•ブログラムは含まれません）についてのみ行われる制限付保証で、その他については保証しないこ 
とを明示します。 

この制限付保趾により、»さんは林体的な法的惟利を付与されます。惟利の内容は W は州によリ托なり、国や州によっては付随的ま 
たは間接的憤害の除去や黙示保証の期間制限を誌めないところもあり、従って、前記の規定が w さんに適用されない場合もあります。 

準拠および一般規定 

本灾施芡約は、カリフォルニア州法に基づき、解釈•規制されるものとし、そのいずれかの条琅が無効または実施不可能の場合にお 
いても、本契約の他の条項の効力は衫響を受けず、その条件通りに実行されるものとします。本契約に基づく敉済手段が、その本来の 
目的を達成できない場合においても、本契約に定める貴任の限定および m 害賠償の除外に W するすべての規定は、全面的にその効力を 
持校するものとします。本契約は、传さんおよびボーランドの梅艰ある代表者が其名した文齊による以外、変史できないものとします。 

私は、前記について统了し、了解いたします。私が抱いたすべての疑問に対しては納得のいく回答がなされています。 

署名欄： _ _ 

会社名： （あてはまる場合のみ} 



齡落签歡 逆^^踩 ti * 廉 斜^^^^^辱，娜 潘溪既^^^^ 二 T 


ドからの製品の出荷をもって、本契約の承諾に代えさせていただきます。 
ランタイム•ライブラリ • ソースコードのご注文に際しては、この 裹 側のベー 
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textcolor (PC-9801). 

textcolor(IBM PC). 

textcursor (PC- 9801 のみ） . 

textmode (PC-9801). 

textmode (IBM PC). 

textreverse (PC-9801 のみ ）… 
textunder (PC-9801 のみ） . 


440 

441 

442 

443 

444 

445 

446 

448 

449 

450 

451 

452 

453 

454 

457 

458 

459 

460 

461 

462 

463 

464 
466 
481 
484 
486 

488 

489 

490 
492 

494 

495 
497 

499 

500 
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textvertical (PC-9801 のみ ）…501 


wherex.502 

グラフィックス関数リファレンス ••… 

arc. 505 

bar . 508 

bar3d . 509 

circle .510 

cleardevice.511 

clearviewport.512 

closegraph .513 

detectgraph. d14 

drawpoly.519 

ellipse .521 

fillellipse.522 

fillpoly.523 

floodfill.524 

getarccoords .526 

getaspectratio .527 

getbkcolor . .528 

getcolor .529 

getdefaultpalette .530 

getdrivername . -531 

getfillpattern.532 

getfillsettings.533 

getgraphmode . .535 

get image. d36 

getlinesettings .538 

getmaxcolor .540 

getmaxmode .545 

getmaxx.546 

getmaxy .547 

getmodename.548 

getmoderange .549 

getpalette .550 

getpalettesize.551 


wherey.503 

window .504 

. 505 

get pixel.552 

gettextsettings .553 

getviewsettings.555 

getx .556 

gety .557 

graphdefaults.558 

grapherrormsg . 559 

graphf reemem.560 

graphgetmem.562 

graphresult.563 

imagesize .565 

initgraph.566 

installuserdriver .572 

installuserfont .575 

line .576 

linerel.577 

lineto . 578 

moverel.579 

mo veto.580 

outtext.581 

outtextxy .582 

pieslice.583 

putimage.585 

putpixel.587 

rectangle.588 

registerbgidriver .589 

registerbgifont .591 

rest orecrt mode.592 

sector .593 

setactivepage.594 

setallpalette .595 

setaspectratio.597 
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setbkcolor .598 

setcolor .600 

setfillpattern .602 

setfillstyle .603 

setgraphbufsize.605 

setgraphmode.607 

setlinestyle.608 

setnewdr i ver (PC-9801 のみ ） 610 

setpalette.611 

setrgbpalette (PC-9801).613 

PC-9801 の ROM BIOS インターフェース. 

パヶット構造体 . 627 

bios98com . 629 

bios98com ch2.633 

bios98com 一 ch3.633 

bios98com init.634 

bios98com init ch2 .636 

bios98com init ch3 .636 

bios98disk.637 

bios98equip.641 

bios98harddisk .643 

bios98key .646 

IBM PC の ROMBIOS インターフェース 

bioscom .672 

biosdisk .675 

biosequip.679 

bioskey .681 

PC-9801 サウンドライブラリ . 

me —block .691 

me —continue.694 

me ground .695 

me initialize. 696 

me inquire .697 

me _mode .699 

日本語処理ライブラリ . 


setrgbpalette(IBM PC) 

settextjustily. 

settextstyle. 

setusercharsize . 

setviewport. 

setvisualpage. 

setwritemode. 

textheight . 

textwidth. 


bios98memory … 

bios98mouse . 

bios98mouse init 

bios98msw . 

bios98print. 

bios98stoptimer ••• 

bios98time . 

bios98timer. 

getfont. 

putuserfont. 


biosmemory 
biosprint •… 
biostime •••• 


me play. 

me _register 
me rom ••… 
me scalar •， 
me stop — 


614 

615 
617 
620 
622 

623 

624 

625 

626 

627 

649 

650 
653 
656 
658 
661 
662 
664 
667 
670 

672 

683 

684 

685 

686 
700 
704 

704 

705 

707 

708 
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漢字オプション 

btom. 

cnkctype. 

hantozen. 

salkana . 

salnmkana •… 

sgrkana . 

skana . 


skanji 

skanji2 

skmoji 

skpun 


ispnkana 

isprkana 



jctime . 
jisalpha 
jisdigit • 
jishira • 
jiskana* 
jiskata - 
jiskigou 
jislO •… 


jisll 

jisl2 


jislower 

jisspace 


710 

jistojms 

711 

jisupper 

712 

jiszen … 

713 

jmstojis 

713 

jstradv … 

714 

jstrchr … 

714 

jstrcmp … 

715 

jstrlen ••• 

715 

jstrmatch 

716 

jstrncat 

716 

jstrncmp 

717 

jstrncpy 

717 

jstrrchr-- 

718 

jstrrev •• 

719 

jstrskip" 

720 

jstrstr •• 

720 

jstrtok •• 

721 

jtohira •• 

722 

jtokana 

723 

jtokata … 

724 

jtolower 

724 

jtoupper 

725 

mtob. 

726 

nthctype 

727 

zentohan 

727 
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はじめに 


このマニュアルは ， Turbo C パッケージの 2 冊目のマニュアル 「Turbo C リファレンス 
ガイド J で， TurboC のライブラリルーチン，コモン変数，コモン型のすべての定義を含 
んでおり，さらにブログラム例を示して，各ルーチン，各変数，各型をどのように使えば 
よいかについて説明してあります。 

C でのプログラミングが初めての場合は， Turbo C の 1 冊目のマニュァル HTurboC ユ 
ーザーズガイド J をまず先に読んでください。ューザーズガイドには， TurboC を使用す 
るシステムでどのようにインストールするか，また TurboC でブログラミングを始める際 
に助けになる人門者向けの章が用意されています。ューザーズガイドには， C 言語が 
TurboC においてどのように実現されているかについての詳細も述べられていますし，少 
し商度なプログラミングテクニックについても触れられています。 Turbo Pascal および 
Turbo Prolog をすでに使っているューザが ， Turbo C を理解しやすくするための章も設 
けられています。 

とにかく，まずューザーズガイドの最初の章「はじめに」に述べられている TurboC 処 
理系に関する情報，ューザーズガイドの内容の要約，簡単な参考文献リストを読んでくだ 
さい 0 




分冊 II :リファレンスガイド 


この TurboC リファレンスガイドは， C について一通りわかっている人のために#？かれ 
ており，言語および実行時の環境に関する処理系特有の詳細について述べられています 0 
そのあと， Turbo C で使用できる関数の定義が ABC 順で与えられています。このリファ 
レンスガイドの各章についての簡単な要約を示します。 

第 1 章 「Turbo C ライブラリルーチンを使うには」では，インクルードファイル (.h ) のリ 
ストと要約， Turbo C ライブラリルーチンのカテゴリ別の一覧を示し， main 間数につい 
て説明しています。そのあと，定義済みのグローバル変数を ABC 順で解説していきます 0 

第 2 章 「Turbo C ライブラリ」では， Turbo C のすベてのライブラリ関数を ABC 順で示 
し，説明を加えます。各関数に対して，その形式，インクルードファイル，関連関数，機 
能の説明，戻り値，可搬性が示されています。なお，テキストビデオライブラリ，グラフ 
イックスライブラリ， BIOS サポートライブラリ，日本語処理ライブラリについては， 
TurboC 標咿ライブラリとは別に，それぞれ節をわけて解説してあります。 


付録 A 「 コンパイラエラーメッセージ j では，すべてのエラーメッセージについて説明 
し，考えられる原因も示しています。 

付録 B 「言語構文の要約」では，修正 BNF ( バッカスナウア記法）で Turbo C のすベて 
の構文が記述されています。 
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はじめに 




マニュアル 表記に関する規約（書体) 


マニュアルの表記に際して使用される特殊なものとして次のようなものがあります。 

[] 害式や MS-DOS コマンドラインにおける大カツコ [] は，システムによって 

興なるオブシヨンの入力やデータを囲むものです。そのとおりにカツコを夕 
イブしてはいけません。 

く〉 関数の説明における不等号は，インクルードファイルを囲むのに使われます。 

Boldface Turbo C の関数名 （ printf など）はこのようなボールド体で表記していま 

す 。 

Gothic Turbo C の丫■■約語 (char, switch, near, cdecl など）はゴシツク体で表わし 

ます。 

Italic 関数に渡す引数名 (string, path など）はイタリツク体で表記します。 

Bold-Italic Turbo C で定拽されているグローバル変数 （ fmode，err no など 、はこの 

m 本で表記します。 

KEYCAPS キーボード上のキー (F10, GRPH-X ， DEL など ) はこの冉体で表記します。 


マニュアル 表 K に関する規約 （害 体) 
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_ 製品に関するお問い合わせ_ 

ソフトウェアおよびマニュアルに関して，ご質問•ご意見などがありましたら，下記の 
MSA カスタマーサボートセンターまで，お電話，咨面またはファクシミリにてお問い合わ 
せください。なお，お電話での受付時間は平日の9 : 00 am 〜12 : 00 am および1: 00pm 
〜5 : 00 pm とさせていただきます（土 Btf ， 日暇祝日は休業とさせていただきますので御 
了承ください）。 

〒107來京都港区南靑山 7-8-1 小田急南靑山ビル 

(株）マイクロソフトウ i アアソシエイツ 

カスタマーサポートセンター 

( TEL ) 03-486-1403 
( FAX ) 03-486-8905 

お問い合わせの際には，下記の事瑣をお伝えください。 

■製品名と バージョン 番号 （Turbo C 2.0 など） 

■製品のシリアル番号（マスターディスクに記載されているもの） 

■コンピュータ名とモデル番号 （ PC -9801 VX など） 

■オ ベレー テイングシステムと バージョン 番号 （ MS-DOS 3.1 など） 

なお，#面にてお問い合わせの際には， CONFIG . SYS およひ • AUTOEXEC . BAT の内 
容，簡潔なブログラムリストを添付されるようお願い致します。 


製品に関するお問い合わせ 
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第 1 章 


Turbo C ライブラリルーチンを使う 


TurboC には， 450 個以上のライブラリルーチン（関数とマクロ）が含まれています 。 C 
のブログラムの中からこれを呼ひ • 出すことができるわけで，じつにさまざまな神:類の仕举 
を行なうことができます。低レベルから商レベルまでの人出力，文字列あるいはファイル 
に対する操作，メモリ割り当て，プロセス制御，データ変換，数学的計筘，その他たくさ 
んのことができるのです。 

Turbo C のルーチンは，ライブラリファイル （ C ズ丄 IB, MATH ズ丄 IB , および 
GRAPHICS 丄 IB) に含まれています。 TurboC では 6 神•妞のメモリモデルが用意されてい 
るので，タイニィを除く各メモリモデルは，それぞれ独自の（各メモリモデル用に邦かれ 
たルーチンも含めて）ライブラリファイルと数学ライブラリファイルを持っています（夕 
イ ニィ モデルはスモールのライブラリファイルを使用します）。 

Turbo C は ANSI の C 標準化案をサポートしており， C のブログラムの中で使用される 
関数に対して，関数プロトタイプを宣言することができます。 TurboC の関数すべてにつ 
いて，ブロトタイブが 1 個または後数のヘッダファイルの中で宣言されています（ヘッダフ 
ァイルは ， • h ファイルやインクルードファイルと呼ばれるもので， INSTALL ブログラム 
によってマスターディスクからサブディレクトり INCLUDE に コピー されるものです）。 

この章では . 


この Turbo C リファレンスガイドの ®: 初の部分では ， Turbo C のライブラリルーチン 
とインクルードファイルを概奴し， main 関数の働き，グローバル変数について説明しま 

to 


■ どんな場合に Turbo C ランタイムライブラリのソースコードが必要になるかについ 
て説明します。 

■ インクルードファイルの一覧表を示し，各々について説明を加えます 0 


製品に関するお問い合わせ 




■ 行なう仕事の種類によってライブラリルーチンを分類します。 

■ main 関数に渡される引数と，その戻り値について説明します。 

■ ライブラリルーチンの多くで使用されるコモングロー八ル変数を， ABC 順で解説しま 
す 0 
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第 1 章 Turbo C ライブラリルーチンを使う 



イブラリルーチン • 

このリファレンスガイドの第2章は，ライブラリルーチンの ABC 順のリファレンスであ 
り， Turbo C ルーチンのすべてについて解説しています。 

いくつかのルーチンは，似通った仕事あるいは深く関連した仕事を行なうために，“ ファ 
ミリィ”としてまとめられています（たとえば，ブログラムを作成，ロード，および実行す 
る exec . •.や spawn .")。 

そうでない関数については，必らず 1 つの項目をとってあります。たとえば， free という 
名前の_数について知りたければ， free の項を見ます。そこには以下のようなことが辨か 
れています。 

■ free が行なうことの要約 

■ free を呼び出すための形式（構文） 

■ free に対するブロトタイブを含んでいるヘッダ ファイルの 名前 

■ free がどのようにインブリメントされているか，および他のメモリ割り当て閲数とど 
のように関連しているかに関する解説 

■同様な関数を含んでいるたのシステムのリスト 

■関連のある他の Turbo C 関数 

■ものによっては，その関数をどのように使えばよいかを示すサンブルブログラム，あ 
るいはサンブルがどこにのっているか 

この リファレンス ガイドの ft 後にある付録では，すべての コンパイラエラーメッセージ 
の説明，および言語桃文の要約が示されています。 


ライブラリルーチン • リフアレンス 


9 


Turbo C ランタイムライブラリ•ソースコード 


Turbo C ランタイムライブラリには，広範な領域をカバーする300以上の関数が含まれ 
ています。 PC の低レベルでの制御， DOS とのインターフェース，人力/出力，ブロセス管 
理，文字列およびメモリ操作，数学計羝，ソート/検索，などです。ランタイムライブラリ 
のソースコードが欲しくなる理由はいくつか考えられます。 

■ Turbo C のある関数が，自分が讲きたい関数に似てはいるけれども，まったくピッタ 
リというわけではないことがあります。ランタイムライブラリ•ソースコードがあれ 
ば，欲しい関数を九々#かなくても，ライブラリ関数を必要に応じて加工することが 
できます。 

■コードをデバッグしているときに，ライブラリ関数の内部についてより詳しく知りた 
くなることがあります0こんなときには，ランタイムライブラリ • ソースコードが大 
きな助けとなるでしょう。 

■ C のシンボルに下線をつける惯例が気にくわず，下線がついていないバージョンのラ 
イブラリが欲しいという人がいるかもしれません。こんな場合も，ランタイムライブ 
ラリ • ソースコードがあれば，下線を取り除いたライブラリを作ることができます。 

■また，プロフェッショナルが*いた緻密なライブラリソースコードから，学び取れる 
ことがたくさんあるでしよう。 

こうした理由から，あるいはまた別の理由から， TurboC ランタイムライブラリ•ソー 
スコードが必要になるでしよう。ボーランドは，•‘オーブンアーキテクチャ”という考えを 
強く持っているので，ライセンス契約によって，ユーザが Turbo C ランタイムライブラ 
リ•ソースコードを利用できるシステムをとっています。ユーザーズガイドの椴初につい 
ている注文肖に必要な亊瑣を記人して送付し，所定の方法で背用をお支払いただければ， 
TurboC ランタイムライブラリ•ソースコードがお手もとに届けられます。詳しくは MSA 
サポートセンターまで問い合せてください。 
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第1章 Turbo C ライブラリルーチンを使う 




Turbo C イン クルー ドファイル 

ヘッダファイルでは，ライブラリ関数の関数プロトタイプが宣言されています。また， 
ライブラリ関数が使用するデータ型やシンボリック定数の定義 ， Turbo C やライブラリ関 
数が定義しているグローバル変数も含まれています 。 Turbo C のヘッダファイル名とその 
内容は， ANSI の C 標准案に従っています。以下のリストでは， ANSIC で定義されてい 
るヘッダファイルにはアスタリスク （*) がつけられています。 

alloc.h メモリ符理関数（割リ当て，解放など）を宣言しています。 

assert.h * assert デバッギングマクロを宣言しています。 

bios.h IBM PC の ROM ルーチンの呼び出しに使用されるさまざまな関数が宣 

言されています (IBM PC のみ）。 

bios 98 .h NEC PC -9801 の ROM ルーチンの呼び出しに使用されるさまざまな関数 

やデータ型が宣言されています （ PC -9801 のみ）。 
conio.h 治:抟コンソール I / O ルーチンを呼び出すのに使われる関数を宣言してい 

ます。 

ctype.h * 文字の分頫，および変換マクロ （isalpha や toascii ) によって使われる悄 

報を含んでいます。 

dir.h ディレクトリやバス名を取り扱う場合に必要となる構造体，マクロ，関数 

を含んでいます。 

dos.h MS - DOS や8086に特有の呼び出しに必要な定数を定義し，宣言を行なっ 

ています。 

errno.h * エラーコードに対応するニーモニック定数を定義しています。 

fnctl.h ライブラリルーチン open と関連して使用されるシンボリック定数を定義 

しています。 

float.h * 浮動小数点ルーチン用のパラメータを含んでいます。 

graphics.h グラフィックス関数のプロトタイブを宣言しています。 
io.h 低レベルの入力/出カルーチンに対する構造体および宣言を含んでいます。 

jctype.h 日本語処理関数が使用する文字分類テーブルなどの情報が含まれています 

( PC -9801 のみ）。 

jstring.h 日本語対応の文字列操作ルーチンのブロトタイブが宣言されています 

( PC -9801 のみ）。 

limits.h * 環境パラメータ，コンパイル時の制限値に関する情報，各棟整数の値の許 


Turbo C インクルードファイル 
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math.h 本 


mem.h 

music.h 

process.h 
setjmp.h * 

share.h 
signal.h * 
stdarg.h * 

stddef.h 木 
stdio.h * 


stdlib.h * 

string.h * 
sys ¥ stat.h 


される範囲などを含んでいます。 

数学関数のプロトタイプを宣言し， HUGE _ VAL マクロを定義し， math - 
err や _ matherr ルーチンによって使用される exeption 構造体を宣言し 
ています。 

メモリ操作関数を宣 H しています（その多くは， string . h の中でも定義され 
ています)。 

PC -9801 のサウンドボードを制御する関数や関連するデータ型を宣言して 
います （ PC -9801 のみ）。 

spawn …および exec …関数用の構造体と宣言を含んでいます。 
longjmp および setjmp 関数によって使われる jmp buf 3'.|を定義し， Ion - 
gjmp と setjmp のブロトタイプを宣言しています。 

ファイルの共有を行なう関数で使用されるバラメータを定義しています。 
signal と raise 関数が使用する定数や宣言を定莪しています。 

引数の個数が可変と宣言された関数 （ vprintf ， vscanf など）で，引数リス 
卜を読むために使われるマクロを定我しています。 

—般的に使われるデータ型やマクロを定我しています。 

カーニハンとリッチイによって定我され， UNIX システム上で拡張され 
た，標准人出カハ•ッケージに必要な型とマクロを定義しています。また， 
標準 I / O ストリーム stdin , stdout , stderr を定義し，ストリームレべル1/ 
0ルーチンを宣言しています（以降カーニハンとリッチイは K & R と略し 
ます)。 

一般的に使用されるルーチン（変換ルーチン，サーチ/ソートルーチン，そ 
の他）を宣言しています。 

文字列操作およびメモリ操作ルーチンを宣言しています。 

フアイルをオーブンしたり，作成したりするのに使われるシンボリック定 
数を定義しています。 


sys ¥ timeb.h fthne 関数と， ftime が返す構造体 timeb を宣言しています c 

sys ¥ types.h 時刻関数とともに使用される型を宣言しています。 

time.h * 時刻変換ルーチン asctime ， localtime ， gmtime で埋められる構造体，お 

よび ctime ， difftime ， gmtime , localtime によって使われる型を定義し 
ています。これらのルーチンのブロトタイプも宣言されています。 
values.h 重要な定数を（マシン依存性も含めて）定我しています 0 UNIX システム 

V との互換性のために提供されています。 
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rmdir (dir^h) 
searchpath (dir.h) 
setdisk (dir.h) 


デイレクトリ垛作ルーチン： 

デイレクトリやバス名を操作するものです。 

chdir (dir.h) getcurdir (dir 

findfirst (dir.h) getcwd (dir 

findnext (dir.h) getdisk (dir 

fnmerge (dir.h) mkdir (dir 

fnsplit (dir.h) mktemp (dir 



イブラリルーチンの分類_ 

Turbo C ライブラリルーチンは，さまざまな種類のタスクを行ないます。この節では， 
ルーチンの一覧表と，そのルーチンが宣言されているインクルード ファ イルも合わせて示 
しています。 

文字分類ルーチン： 

ASCII 文字を，英字，コント ロール 文字，区切り文字，英大文字，などに分類するも 
のです。 

isalnum (ctype.h) isdigit (ctype.h) ispunct (ctype.h) 

“alpha (ctype.h) isgraph (ctype.h) isspace (ctype.h) 

i8a8cii (ctype.h) islower (ctype.h) isupper (ctype.h) 

iscntrl (ctype.h) isprint (ctype.h) isxdigit (ctype.h) 

変換 ルーチン： 

文字や文字列を変換するものです。文字列から数値(浮動小数点数，览数，倍長整数) 
への変換や，その逆の変換，英大文字から，英小文字への変換やその逆，といったも 
のです。 

atof (stdlib.h) itoa (stdlib.h) tolower (ctype.h) 

atoi (stdlib.h) ltoa (stdlib.h) .tolower (ctype.h) 

atol (8tdlib»h) strtod (stdlib.h) toupper (ctype.h) 

ecvt (stdlib.h) strtol (stdlib.h) 一 toupper (ctype.h) 

fcvt (stdlib.h) strtoul(stdlib.h) ultoa (stdlib.h) 

gcvt (stdlib.h) toascii (ctype.h) 


IT \/ 
h h h h 


ライブラリ ルーチンの 分類 
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グラフイツクスルーチン： 

画面上にテキストを含むグラフ ィッ クスを作成するルーチンです0 



bar 

bar3d 

circle 



clearviewport 

closegraph 

detectgraph 

drawpoly 

ellipse 

fillellipse 

fillpoly 

floodfill 



getbkcolor 

getcolor 

getdefaultpalette 

getdrivername 



getgraphmode 

getimage 

getlinesettings 

getmaxcolor 

getmaxmode 

getmaxx 

getmaxy 



getx 

gety 


graphdefaults 
grapherronnsg 
_graphfreemem 
_graphgetmem 


(graphics.h) 
(graphics.h) 
(graphics *h) 
(graphics *h) 
(graphics.h) 
(graphics.h) 
(graphics.h) 
(graphics.h) 
(graphics.h) 
(graphics.h) 
(graphics «h) 
(graphics.h) 
(graphics *h) 
(graphics.h) 
(graphics.h) 
(graphics.h> 
(graphics.h> 
(graphics.h) 
(graphics.h) 
(graphics.h) 
(graphics.h) 
(graphics.h) 
(graphics.h) 
(graphics.h) 
(graphics.h) 
(graphics «h) 
(graphics.h) 
(graphic8.h) 
(graphics.h) 
(graphics.h) 
(graphics.h> 
(graphics «h) 
(graphics.h) 
(graphics.h) 
(graphics.h) 
(graphics.h) 
(graphics.h) 
(graphics.h) 
(graphics.h) 
(graphics.h) 
(graphics.h) 


imagesize 

initgraph - 

installuserdriver 

installuserfont 

line 

linerel 

lineto 

moverel 

moveto 

outtext 

outtextxy 

pieslice 

putimage 

putpixel 

rectangle 

regi8terbgidriver 

registerbgifont 

restorecrtmode 

sector 

setactivepage 


seta8pectratio 

setbkcolor 

setcolor 

setfillpattern 

8etfill8tyle 

setgraphbufsize 

setgraphmode 

8etline8tyle 

8etnewdriver 

setpalette 

setrgbpalette 

settextjustfy 

settextstyle 

setusercharsize 

setviewport 

setvisualpage 

setwritemode 


teztheight 

textwidth 
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入力/出カルー 

ストリー 


DOS レベルの I / O 機能を提供するルーチンで 


chmod 

chsize 


(stdio.h) 

putw 

(stdio.h 

r (stdio.h) 

一 read 

(io.h) 

(stdio.h) 

read 

(io.h) 

(stdio.h) 

remove 

(stdio.h 

(stdio.h) 

rename 

(stdio.h 

(stdio.h) 

rewind 

(stdio. 

(stdio.h) 

scanf 

(stdio. 

(stdio.h) 

setbuf 

(stdio. 

(8y8¥stat.h) 

setftime 

(io-h) 

(stdio.h) 

setmode 

(io-h) 


io. 

io. 

io. 


faopen 

feof 

ferror 


tdi 
tdi 
8tdio.h) 
8tdio.h) 


put 8 


di 
di 
di 
. : di 
(8tdio.h) 


write (stdio.h) 


の分類 












インターフヱースルーチン （ MS - DOS , 8086) 


MS - DOS , 8086など，マシン特有の機能を与えます。 


absread 

(do8.h) 

getfatd 

abswrite 

(do8.h) 

getpsp 

bdos 

(do8.h) 

getvect 

bdosptr 

(dos.h) 

getverify 

country 

(dos.h) 

harderr 

ctrlbrk 

(dos.h) 

hardresume 

disable 

(dos.h) 

hardretn 

dosexterr 

(dos.h) 

inport 

enable 

(dos.h) 

inportb 

FP_0FF 

(dos.h) 

int86 

FP:SEG 

(dos.h) 

int86x 

f reemem 

(dos .h) 

intdos 

geninterrupt 

(dos.h) 

intdosx 

getcbrk 

(dos.h) 

intr 

getdfree 

(dos.h) 

keep 

getdta 

(dos.h) 

MK_PP 

getfat 

(dos.h) 



(dos 

h) 

outport 

(dos 

h) 

(dos 

h) 

outportp 

(dos 

h) 

(dos 

h) 

parsfnm 

(dos 

h) 

(dos 

h) 

peek 

(dos 

h) 

(dos 

h) 

peekb 

(dos 

h) 

(dos 

h) 

poke 

(dos 

h) 

(dos 

h) 

pokeb 

(dos 

h) 

(dos 

h) 

randbrd 

(dos 

h) 

(dos 

h) 

randbwr 

(dos 

h) 

(dos 

h) 

segread 

(dos 

h) 

(dos 

h) 

setcbrk 

(dos 

h) 

(dos 

h) 

setdta 

(dos 

h) 

(dos 

h) 

setvect 

(dos 

h) 

(dos 

h) 

setverify 

(dos 

h) 

(dos 

h) 

sleep 

(dos 

h) 

(d09 

h) 

unlink 

(dos 

h) 


文字列，メモリ操作ルーチン： 

文字列あるいはメモリブロックを操作するものです。コピー，比較，変換，探索など 
を行ないます。 


memccpy 

memchr 

memcmp 

memcpy 

memicpy 


(mem.h f 

(mem.h. 



string.h) 

string.h) 

string.h) 

8tring.h) 


(mem.h f string.h) 


mexnmove 
memset 
lata 


>vedi 

>vmet 


setmem 


(mem.h, 

(mem.h, 

(mem.h t 

(mem.h t 

(mem.h) 


string.h) 

string.h) 

string.h) 

string.h) 


stpcpy (string.h) 

strcat (string.h) 


strchr (string.h) 
strcmp (string.h) 
strcmpi (string.h) 
strcpy (string.h) 
strcspn (string^h) 
strdup (string.h) 
strerror (string.h) 
stricmp (string.h 〉 
strlen (string.h) 
strlwr (string.h) 
strncat (string.h) 
strncmp (string.h) 


8trncmpi (string.h) 
8trncpy (string.h) 
8trnicmp (string.h) 
8trnset (string.h) 


trpbrk 
rrchr 
rrev 


st 

st 


(string.h) 

(string.h 〉 

(string.h) 


trset (string.h) 


trspn (string.h) 


trstr (string.h) 


strtok (string.h) 
strupr (string.h) 
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数字ルーチン： 

数学的計算や変換を行なうものです。 


abs 

(stdlib.h) 

floor 

(math.h) 

pow 

(math.h) 

acos 

(math.h) 

fmod 

(math.h) 

powlO 

(math.h) 

asin 

(math.h) 

_fpreset 

(float.h) 

rand 

(stdlib.h) 

atan 

(math.h) 

frexp 

(math.h) 

random 

(stdlib.h) 

atan2 

(math.h) 

gcvt 

(stdlib) 

randomize 

(stdlib.h) 

atof 

(math.h, stdlib.h) 

hypot 

(math.h) 

一 rotl 

(stdlib.h) 

atoi 

(stdlib.h) 

itoa 

(stdlib.h) 

一 rotr 

(stdlib.h) 

atol 

(stdlib.h) 

labs 

(stdlib.h) 

8 in 

(math.h) 

cabs 

(math.h) 

ldexp 

(math.h) 

8inh 

(math.h) 

ceil 

(math.h) 

ldiv 

(stdlib.h) 

sqrt 

(math.h) 

_clear87 

(float.h) 

log 

(math.h) 

8 rand 

(stdlib.h) 

一 control87 

(float.h) 

loglO 

(math.h) 

_8tatus87 

(float.h) 

cos 

(math.h) 

_lrotl 

(stdlib.h) 

strtod 

(stdlib.h) 

cosh 

(math.h) 

一 lrotr 

(stdlib.h) 

strtol 

(stdlib.h) 

div 

(stdlib.h) 

ltoa 

(stdlib.h) 

strtoul 

(stdlib.h) 

ecvt 

(stdlib.h) 

一 matherr 

(math.h) 

tan 

(math.h) 

exp 

(math.h) 

matherr 

(math.h) 

tanh 

(math.h) 

fabs 

(math.h) 

modf 

(math.h) 

ultoa 

(stdlib.h) 

fcvt 

(stdlib.h) 

poly 

(math.h) 




メモリ割り当てルーチン： 

スモールデータモデルおよひ•ラージデータモデルで， 動的 メモリ割り当てを行なうル 
ーチンです0 


allocmem 

(dos.h) 

farmalloc 

brk 

(alloc.h) 

farrealloc 

calloc 

(alloc.h) 

free 

coreleft 

(alloc.h f stdlib.h) 

malloc 

farcalloc 

(alloc.h) 

realloc 

farcoreleft 

(alloc.h) 

8 brk 

farfree 

(alloc.h) 

setblock 


(alloc.h) 

(alloc.h) 

(alloc.h f stdlib.h) 
(alloc.h f stdlib.h) 
(alloc.h, stdlib.h) 
(alloc.h) 

(dos^h) 


その他のルーチン： 

ローカルでない goto 機能や，ビープ音の制御などを与えます （* は PC -9801 のみの関 
数です)。 


beep * 
delay 
getfont * 
longjmo 


(do8*h) 

(dos.h) 

(dos.h> 

(setjmp.h) 


nosound (dos *h) 

putuserfont * (dos.h) 
setjmp (setjmp-h) 

sound (dos.h) 


ライブラリルーチンの分類 
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)， 終了させたりするものです。 



random 

randomize 

(stdlib 

h) 

(stdlib 

h) 

realloc 

(stdlib 

h) 

rotl 

(stdlib 

h) 

_rotr 

(stdlib 

h) 

8 rand 

(stdlib 

h) 

8trtod 

(stdlib 

h) 

strtol 

(stdlib 

h) 

strtoul 

swab 

(stdlib 

h) 

(stdlib 

h) 

system 

(stdlib 

h) 

ultoa 

(stdlib 

h) 


です（ホは PC -9801 のみの関数で 


h) textcursor * (conio.h) 
h) textmoae (conio.h) 




















時刻および日付ルーチン： 


時钊変換，時刻操作のルーチンです。 


asctime 

ctime 

difftime 

dostounix 

ftime 


(time.h) 

(time.h) 
(time.h) 
(dos.h) 
(8ys¥timeb.h) 


getdate 

gettime 

gmtime 

localtime 

setdate 


(dos.h) 

(dos.h) 

(time.h) 

(time.h) 

(dos.h) 


settime 

stime 

time 

tzset 

unixtod 08 


(dos.h) 

(time.h) 

(time.h) 

(time.h) 

(dos.h) 


変数引数リストルーチン： 

vprintf などの中で，変数引数のリストにアクセスする場合に使います。 



(stdarR.h) 


va end 


(stdarg^h) va start (stdarg.h) 


BIOS インターフ x - ス （ PC -9801): 


PC 9801 の ROM-BIOS を呼び出すルーチンです0 


bios98com 

(bios98 

h) 

bios98key 

(bios98 

h) 

bios98com ch2 

(bios98 

h) 

bio898memory 

(bios98 

h) 

bios98com ch3 

(bios98 

h) 

bios98mouse 

(bios98 

h) 

bio898com_init 

(bio898 

h) 

bios98mouse 一 init 

(bios98 

h) 

bios98com_init 一 ch 2 

(bios98 

h) 

bio898msw 

(bios98 

h) 

bio898com_init ch3 

(bios98 

h) 

bios98print 

(bios98 

h) 

bio898di8k 

(bios98 

h) 

bios988toptiiner 

(bios98 

h) 

bio898equip 

(bio898 

h) 

bios98time 

(bios98 

h) 

bio898harddi8k 

(bios98 

h) 

bio898timer 

(bios98 

h) 


BIOS インターフェース IBM PC ) : 

IBM PC の ROM BIOS を呼び出すルーチンです。 


bio8Com 

biosdisk 

biosequip 


(bios.h) 
(bios.h) 
(bios.h) 


bioskey 

bio8memory 


(bios.h) 

(bios.h) 


biosptint 

biostime 


(bios.h) 

(bios.h) 


ライブラリルーチンの分類 





日本語処理ルーチン （ PC -9801 のみ）： 

日本語対応の文字列操作および文字分類ルーチンです。 


btom 


alkana 
alnmkana 
grkana 
kana 
kanji 
kanji2 
kmoji 
kpun 
pnkana 
isprkana 
ja8Ctime 
jctime 
jisalpha 
jisdigit 


(jstring.h) 
ctype. 
ctype. 
ctype. 
ctype. 
ctype. 
ctype. 
ctype. 
ctype. 
ctype • 
ctype • 
ctype • 
ctype• 
ime.h) 
ime.h) 
type.h 
type.h 


jishira (jtype.h) jstrmatch (jstring.h) 

ype.h) jstrncat (jstring. 

ype•h > jstrncmp (jstring. 

―ぃ …- String. 

tring. 
tring. 
tring. 

• tring. 

: tring. 
ype-h) 
ype.h) 
•ype.h) 
•ype.h) 
ype.h) 

: tring• 
ype.h) 
ype.h) 


ype 

ype 

ype 

ype 


ype.h) 

ype.h 〉 

ype.h) 

ype.h) 

ype.h 〉 

ype.h) 

ype.h) 

tring. 

tring. 

tring. 

tring. 


ohira 
okana 
okata 
010 wer 
oupper 


mc_mode 

mc_play 


ーチンを使う 









main 関数 


c のブログラムには，すべて main 関数がなければなりません（それをどこに置くかは, 
好みの問題ですが)。 main をファイルの先頭に置くブログラマもあり，一番最後に置く人 
もいます。しかし，逋かれる位置とは関係なく， main 関数に対しては，以下に示すような 
ポイントが必らず適用されます。 


main への引数 


ここに示すのは， TurboC スタート アッ ブルーチンによって main に渡されるパラメー 
夕（引数)， argc, argv, および e /? v です。 

■整数 flrgc は， main に渡されるコマンドライン引数の個数です。 

■ argv は文字列へのポインタの配列です。 

• バージヨン 3 •ズの MS-DOS では，は実行されるブログラムのフルパスと 
して定我されます。 

•バージヨン 3.0 未満の MS-DOS の下では， flav[0] はヌル文字列（，，，，）を指しま 
す 。 

• a7v[l] は， MS-DOS のコマンドラインでブログラム名の後に®:初にタイプされ 
た文字列を指しています。 

• argv [2] は，ブログラム名の2つ後にタイプされた文字列を指しています。 

• argv[argc-l] は， main に渡された最後の引数を指しています。 

• argv[argc]lt NULL になります。 


v も文字列へのポインタの纪列です。 e / iv [] の各要素は， ENVVAR = value の形式の 
文字列を指しています。 

• は環境変数の名前で， PATH ， 87などがあります。 

• 邊 e は ENVVAR にセットされる値で，たとえば PATH には A : ¥ DOS;A : 
¥ TURBOC などが，87には YES などが与えられます《 


main 関数 
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TurboC スタートアップルーチンは，必らずこの三つの引数を main に渡しますが，プ 
ログラムの中でこれらを定義するかどうかはプログラマが決めることができます。これら 
の引数の内のいくつか（あるいはすべて）を宣言すれば， main ルーチン内でローカル変数 
として使えるようになります。 

ただし，これらのパラメータを宣言する場合は，必らず， argc , argv % env , の順で宣言 
しなければならないことに注意してください。 

以下に示す例は， main の引数の宣言として，いずれも有効です。 

main(int argc) I * 有効だが一败的ではない */ 

main(int argc. char * argv()) 

main(int argc. char * argv[ ] f char * env[)) 

注意 1: 二番 H の宣言 main(int argc ) は誤りではありませんが，ブログラム内で argv の 
要素は使わずに argc を使うということで，あまり一般的ではありません。 

注意 2:引数州 v は，グローバル変数を通してでも使用することができます。こ 
の章の environ の現およひ•第2章の putenv と getenv の取を見れば，より詳しい悄報が 
得られます。 

argc , argv ， env を使用するサンプルプログラム 


次に示す例は， main に渡されるこれらの引数を利用する方法を示すブログラム （ ARGS . 
EXE ) です。 

プログラム ARGS.EXE ♦/ 

include <stdio.h> 
include <8tdlib.h> 

main(int argc, char *argv[] t char *env [】） 

{ 

int i; 

printf('The value of argc is Zd ¥n¥n* 9 argc); 

printf(■These are the Zd command-line arguments passed to main ： ¥n¥n_• 
argc); 

for (i - 0 ； i <- argc ； i++) 

printfC argv[Xd]s 2s¥n B f i f argv(ij )； 

printf( B ¥nThe environment string(s) on this system are ： ¥n¥n B )； 

for (i - 0 ； env[i] !- HULL; i++) 

printfC env[Id)t 2s¥n- f i f env[i ])； 
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このプログラム ARGS . EXE を， MS - DOS のブロンブトから次のようなコマンドライン 
で実行したとします。 

A:¥> args first_argument ■argument with blanks - 3 4 "last but one - stop! 

この例の” argument with blanks ” や ” last but one ” のように，二重引用符で囲めば，空 
白を含む引数も渡せることに注意してください。 

ARGS . EXE の出力は，（環境変数がここに示すように設定されているとすれば）次のよ 
うになります。 

The value of argc is 7 

These are the 7 command-line arguments passed to main ： 


argv 

0) 

A:¥TURBOC¥ARGS.EXE 

argv 

1 】 

first 一 argument 

argv 

2 】 

argument with blanks 

argv 

3 】 

3 

argv 

合】 

4 

argv 

5 】 

last but one 

argv 

6 】 

stop! 

argv 

7 】： 

(null) 


The environment string(s) on this system are: 

env(0J: COMSPEC-A:¥COMMAND.COM 
env[lj: PROMPT-$p$g 

env [ 2 】 •• PATH-A: ¥SPRINT;A: ¥DOS;A: ¥TURBOC 

注意 ： main に渡されるコマンドライン全体の肢大の長さは（引数の区切りの空白も含め 
て）128文字になります。これは MS - DOS の制限です。 


main へのワイルドカード引数 


ワールドカード文字を含むコマンドライン引数は， DOS が COPY コマンドに渡された 
ワイルドカードを展開するのとまったく同じ方法で，一致するすべてのファイル名に展開 
されるようにすることができます。ワイルドカードの展開に必要なことは， TurboC に含 
まれているオブジェクトファイル WILDARGS . OBJ をブログラムにリンクするだけです。 

WILDARGS . OBJ がブログラムコードにリンクされていれば，*.*などの形式のワイ 
ルドカード引数を main 関数に送ることができます。ワイルドカード引数は， （ argv 配列の 
中に）ワイルカードマスクに一致するすべてのファイル名として展開されます。 argv 配列 
の最大サイズは，ヒーブ中で使用可能なメモリの最によって変化します。 

一致するファイルが見つからない場合は，引数はそのまま渡されます（つまり，ワイル 
ドカードを含む文字列が main に渡されます)。 


main 関数 
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例： 次の2つのコマンドは，ファイル ARGS . C をコンパイルしてワイルドカード展開モジ 
ュール WILDARGS . OBJ をリンクし，作成された実行可能ファイル ARGS . EXE を実行し 
たものです。 

tcc args wildargs.obj 
args A: ¥TURBOC¥INCLUDE¥* • H 

ARGS . EXE が実行されると，肢初の引数は ， A : ¥ TURBOC ¥ INCLUDE ディレクト 
リにあるすべての . H ファイル名に展開されます。展開後の引数文字列には，完全なパスが 
含まれることに注意してください（たとえば A : ¥ TURBOCV INCLUDE ¥ ALLOC . 
H ) 0 2番目の引数* . C は，引用符で囲んであるので展開されません。 

統合 B 3 境 ( TC . EXE ) の場合には，次のような内容のブロジヱクトファイルを作って，そ 
のファイル名を Project/Project name で指定してください。 

ARGS 

WILDARGS.OBJ 

そして， Options / Arguments オプションを使って，コマンドライン引数をセットしま 
す。 

注意： いちいち WILDARGS . OBJ をリンクしなくても，ワイルドカードの展開がデフォ 
ルトで可能となるようにしたい場合は，樣準のライブラリファイル C ズ丄 IB に WILDAR ¬ 
GS.OBJ を組み人れてしまう ことができます。 これを行なうには，樣準ライブラリから 
SETARGV モジュールを削除して， WILDARGS を追加します。次の コマン ドは ， Turbo 
ライブラリアン TLIB を呼び出して，すべての標準ライブラリを変更しています（これ 
は，標準 C ライブラリと WILDARGS . OBJ がカレントディレクトリにある場合です）〇 


tlib 

C8 

-setargv 

+wildarg8 

tlib 

CC 

-setargv 

+wildarg8 

tlib 

cm 

•setargv 

+wildarg8 

tlib 

cl 

-setargv 

wildargs 

tlib 

ch 

-setargv 

wildargs 
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P オプシヨンを使ったコンパイル 
(Pascal の呼び出し慣例） 


Pascal の呼び出し惯例 （ユーザーズ ガイドの第12章に詳細があります）を用いてブログ 
ラムを コンパイ ルする埸合は， main が C のタイプであることを明示して宣言しなければ 
なりません。 

それには，次のように予約語 cdecl を使います。 
caecl main(int argc, char *argv[], char *envp【】> 

main が返す値 


main が返す値は，そのブログラムのステータスコード （ int ) になります。ただし，ブロ 
グラムの終了に exit ルーチン（あるいは exit) を使うと， main が返す値は exit (あるい 
は _exit) を呼び出すときに渡された引数の値になります。 

たとえば，ブログラムが次のような呼び出しをしていると，ステータスは1になります。 

exit ⑴ 

TurboC の統合琛境版 （ TC . EXE ) を使っている場合には，ブログラムの実行が終了し 
てから ， Compile メニューの Get info を選べば ( ORPHIC , (3)， main からの戻り値を見 
ることができます。 

"Function should return a value ” （関数は値を返さなければならない）の警告をオン 
にしている場合 （- wrvl または 0/ C / Errors/Common errors/A ••… On )， そのチェック 
は main 関数にも適用されます。 main に対してこの費告を出したくなければ， return 文で 
値を返すようにするか， main を次のように void 型と宣言するようにしてください。 


void main() 


main 関数 
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ー バル 変数 


—8087 

機能 コプロセッサチップフラグです。 

形式 extern int 8087 : 

宜首 ファイル dos.h 

解脱 変数 _ S ( W 7 は，スタートアップコードの自動検出ルーチンが浮動小数点コ 

プロセッサ （8087, 80287,あるいは8038 7) が装着されていることを検出 
した場合には，0でない値（チップの M 類によってそれぞれ1, 2,あるいは 
3) にセットされます。そうでない場合には，_8087は0にセットされま 
す。 

自動検出機能は，環境変数87を YES または N 0にセットすることによっ 
て無効にすることができます （ DOS のブロンブトから SET 87 = YES ある 
いは SET 87 = N 0という コマン ドを与えます。等号の前後にスペースを入 
れてはいけません）。この場合に は—8087 の値は，環境変数の値にしたがっ 
て l ( YES ) または 0( NO > にセットされます。 

環境変数87については，ユーザーズガイドの第12章を参照してください。 
ブログラム内に浮動小数点コードが含まれている場合， 一8087 は適切な 
値 （1 〜 3) にセットされていなければなりません。 
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argc 


機能 

コマンドライン引数の個数を保持しています。 

形式 

extern int argc : 

宜言 ファイル 

dos.h 

解脱 

argc ii , プログラムの実行開始時に main に渡された argc の値を持って 

います。 

argv 

機能 

コマンドライン引数へのポインタの列です。 

形式 

extern char * orgv [] \ 

宜言 ファイル 

dos.h 

解脱 

— arfiri ; は，ブログラムの実行開始時に main に渡されたもともとのコマン 

ドライン引数 （ argv [] の要素）を持つ配列を指しています。 


グローバル変数 
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daylight 

機能 g 時間が有効かどうかを示しています。 

形式 extern int daylight \ 

宜言ファイル time.h 

解脱 daylight は， 時刻日付関数によって使用されます。 

daylight は， tzset , ftime およひ • localtime 関数によって，#時間の実施 
期間中であれば1,標準時間中であれば0にセットされます。 


directvideo 

機能 ビデオ出力を制御するフラグです。 

形式 extern int directvideo; 

宜曾ファイル time.h 

解脱 は，ブログラムの コンソール 出力 （ cputs などによるもの） 

が，直接ビデオ RAM に#き込まれる （rf か枕れ ; Weo = 1) か ， ROM BIOS 
を通じて送られる （rffrec か Weo = 0) かを制御しています。 
デフォルト値は rffrec か Weo =1で，コンソール出力はビデオ RAM に直 
接送られます 。 disrectvideo = 1として使用する場合には，システムのビ 
デ オハー ドウェアは， IBM のディ ス ブレイアダブタと完全な互換性がなけ 
ればなりません 。 directvideo = 0にセットしている場合には，コンソー 
ル出力は IBM BIOS とコンパチブルなすべてのシステムで動作します。 

注意 ： PC — 9801用では，は宣言はされていますが，まったく 
使用されていません。 
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environ 


機能 DOS の S 3 境変数へのアクセスです。 

形式 extern char * environ []\ 

宜言ファイル dos.h 


解脱 environ は文字列へのポインタの S 己列で，ブロセスの環境にアクセスした 

り，環境を変更したりする場合に使用します。各文字列は次のような形式 
になっています。 

varname - varvalue 


varname は環境変数の名前 （ PATH など)， varva / we は環境変数 （ 

にセットされている値 ( A : ¥ BIN;A : ¥ DOS など）です。文字列 varva/we 
は空の場合もあります。 

ブログラムの実行開始時に， MS - DOS の環境設定は，直接そのブログラム 
に渡されます 0 main への3番目の引数 envp ( i , enw><m の初期設定と同じ 
であることに注意してください。 

em ; i>on 配列は， getenv 関数によってアクセスすることができますが，配 
列 environ の要素の，追加，変更，削除が行なえるのは putenv 関数だけ 
です。これは，修正によってブロセス環境変数の大きさが変更されたり， 
再配置されたりしても， endro / i は自動的に調整されてその配列を指して 
いるようにするためです。 


グローバル変数 
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errno, doserrno, sys errlist，sys nerr 

機能 perror がエラーメッセージをプリントすることを可能にします。 

形式 extern int errno \ 

extern int doserrno \ 
extern char * sys errlist ; 
extern int sys _ nerr \ 

宜言ファイル errno . h ， stdlib.h ( errno , doserrno , sys err list , sys nerr ) 

dos.h ( doserrno ) 

解脱 errno . sys errlist，sys nerr ；±, ライブラリルーチンが指定されたタス 

クが実行できなかったときに， perror 関数がエラーメッセージを出力する 
ために使用します。 doserrno li , 多くの DOS エラーコードを errno に 
対応させる変数です。ただし， perror doserrno を®;接使用することは 
ありません。 

doserrno '. DOS システムコールがエラーとなった場合， doserr/io に 
は， DOS の実際のエラーコードがセットされます。 errno は，ほぼ同様な 
変数です力ぐ， UNIX システムから引き継いでいるものです。 

errno :システムコールでエラーが起こった場合， errno はエラーのタイ 
プを示すようにセットされます。 errno が doserr/io と同じ‘ともありま 
すが， errno には MS-DOS のエラーコードが含まれない { doserrno には 
含まれている）こともあります。また逆に， err/io だけがセットされて， 
doserrno はセツ トされない場合もあります 0 

8 卵 errtist ••メ ッセージの宵式を制御するために，メッセージ文字列の配 
列が， sys — errlist と して与えられています。 errno はこの配列の添字とし 
て使われ，エラー番号に対応する文字列を見い出すことができます。文字 
列には改行文字は含まれていません。 
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sys nerr :この変数は，叫 s errZisf 内に含まれているエラーメ ッ セージ 
の個数として定義されています0 

以下に示すのは ， sys err list 内に格納されている値に対するニーモニツ 
クとその意味です。 


ニーモニック 意味 


E 2 BIG 

EACCES 

EBADF 

ECONTR 

ECURDIR 

EDOM 

EEXIST 

EINVACC 

EINVAL 

EINVDAT 

EINVDRV 

EINVENV 

EINVFMT 

EINVFNC 

EINVMEM 

EMFILE 

ENMFILE 

ENODEV 

ENOENT 

ENOEXEC 

ENOFILE 

ENOMEM 

ENOPATH 

ENOSPC 

ENOTSAM 

ERANGE 


引数リストが長すぎる 

アクセス権が無い 

ファイル番号が正しくない 

メモリブロックが壊れている 

カレントディレクトリを削除しようとした 

定義域 エラー 

ファイルはすでに存在している 

アクセスコードが正しくない 

引数が正しくない 

データが正しくない 

指定されたドライブが正しくない 

環境が正しくない 

»式が正しくない 

ファンクション番号が正しくない 

メモリブロックアドレスが正しくない 

オーブンファイルが多すぎる 

これ以上のファイルはない 

そのデバイスは存在しない 

そのファイルあるいはディレクトリは存在しない 
exec 書式 エラー 

そのファイルあるいはディレクトリは存在しない 

メモリが足りない 

八スが見つからない 

UNIX である 一 DOS ではない 

同一のデ八イスではない 

値域エラー（結果が指定の範囲を越えた） 


グローバル変数 
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EXDEV 

EZERO 


クロスデバイスリンク 
エラー0 


次に不すのは， rfoserr / io にセットされる，実際の MS - DOS のエラーコー 
ドに対する二ーモニック です。— do 8 errno は， errno を通じて， s 仰 errlist 
内のエラーメッセージ文字列に対応づけされる場合と，されない場合があ 
ります。 


ニーモニック 

意味 

EINVAL 

無効なファンクション 

E 2 BIG 

不正な環境 

EACCES 

アクセスは否定されている 

EACCES 

無効なアクセス 

EACCES 

カレントディレクトリである 

EBADF 

無効なハンドル 

EFAULT 

(予約されています） 

EINVAL 

無効なデータ 

EMFILE 

オーブンされているファイルが多すぎる 

ENOENT 

そのようなファイルまたはディレクトリはない 

ENOEXEC 

不正なフォーマット 

ENOMEM 

メモリコントロールブロックが破壊されている 

ENOMEM 

メモリが不足した 

ENOMEM 

無効なメモリブロック 

EXDEV 

無効なドライブ 

EXDEV 

同じデ八イスではない 


DOS のエフーリターンコードについては， MS - DOS ブログラマーズリフ 
アレンスマニュアルにより詳しい情報があります。 
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fmode 


機能 デフォルトのファイル変換モードを決定します。 

形式 extern unsiged fmode \ 

宜首 ファイル fcntl.h 

解脱 / Vnorfe は，ファイルがどのモード（テキストまたはバイナリ）でオーブン 

され，変換が行なわれるかを決めるものです。 fmode の初期値は0 
TEXT であり，この場合ファイルはテキストモードで统まれます。ゾ morfe 
が OBINARY にセットされると，フアイルはバイナリモードでオーブン 
され，統まれます （0_ TEXT と 0_ BINARY は， fcntl . h の中で定我されて 
います)。 

テキストモードでは，入力時に， CR / LF のベアは LF 1 文字に変換されま 
す。出力時にはその逆の変換が行なわれ， LF は CR / LF に変換されます。 
バイナリモードではこのような変換は行なわれません。 

ライブラリルーチ fopen , fdopen ， および freopen の引数 type に， ” t ” （テ 
キストモード）または” b ” （バイナリモード）を指定すれば， _ fmode によ 
つてセットされているデフォルトのモードは無効にすることができます。 
また，ライブラリルーチン open でも，引数 accew に O BINARY または 
0_ TEXT を指定すれば， open の引数/?で示されたファイルを， 
ハ•イナリモード，テキストモードどちらでオーブンするかを決めることが 
できます。 


グローバル変数 
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heaplen 

機能 ヒープサイズを保持しています。 

形式 extern unsigned heaplen : 

解脱 heaplen は， スモールデータモデル（タイニイ，スモール，ミデイアム） 

では， near ヒープのサイズを示しています。ラージデータモデル（コンパ 
クト，ラージ，ヒュージ）では near ヒープがないため， heaplen も存在 
しません。 

スモールおよびミディアムモデルでは，データセグメントのサイズは次の 
ようにして計棘されます。 


=グローバルデータ+ヒープ+スタック 

ここで，スタックサイ ズは 8 tklen によつて調整することができます。 

heap fen が〇にセットされている場合は，ブログラムはデータセグメント 
に 64 K バイトを割り当て，ヒープの実効サイズは次のようになります。 

64 K • (グローバルデータ+スタック）バイト 

デフォルト では heaplen = 0 なので， heaplen になんらかの値を指定しな 
ければ， 64 K のデータセグメントが得られることになります。 

タイニイモデルでは，コードも含めたすべてが同一のセグメントに3¢かれ 
るので，データセグメントは，コードと，ブログラムセグメントブレフイ 
クス ( PSP ) の256バイトを含む長さに調整されます。 

データセグメント= 256 +コード+グ□ーバルデータ 

+ヒープ+スタック 
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タイニィモデルで _AeapZen = 0 の場合，ヒープの実効サイズは， 64 K から, 
PSP , コード，グローバルデータ，およびスタックを引いたものになりま 
す。 

コンパクトおよびラージモデルでは， near ヒープは存在しないので，デー 
タセグメントは次のように単純に求められます。 


データセグメント=グローバルデータ十スタック 

ヒュージモデルでは，スタックは別個のセグメントにとられ，各モジュー 
ルはモジュールごとにデータセグメントを持ちます。 


閲連項目 stklen 


グローバル変数 
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osmajor ， osminor 


機能 DOS の八ージョン番号のメジャー部およひ•マイナー部を保持しています。 

形式 extern unsigned char osmajor \ 

extern unsigned char osminor \ 


宜言ファイル dos.h 


解脱 DOS ハ•ージョンのメジャー部とマイナー部は， osmajor と osminor に 

よって別々に得ることができます。メジャーバージョン番号が _ o 8 maJor 
に，マイナー八ージョン番号が osminor に入っています。 

これらの変数は， MS - DOS のバージョン2•ズと3.ズの_方で走るモジユー 
ルを必要とする場合に便利です。ライブラリルーチンの中には， MS-DOS 
の八ージョンによって動作が異なるものがいくつかあり，バージョン 3 .x 
の下でしか動作しないものもあります（第2章の， open , creatnew，ioctl 
の項を参照してみてください）。 


^psp 


機能 PSP のセグメントアドレスを保持しています0 

形式 extern unsigned /nt psp ； 


宜曾ファイル dos.h 


解脱 psp は，現在のブログラムに対するブログラムセグメントプレフィクス 

( PSP ) のセグメントアドレスを保持しています0 PSP は DOS のプロセス 
ディスクリプタであり，ブログラムについての DOS の初期情報を含んで 
います。 

PSP に関する詳細な悄報については， MS - DOS ブログラマーズリファレ 
ンスマニュアルを参照してください。 
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stklen 


名前 スタックサイズを保持しています。 

形式 extern unsigned stklen \ 

宜言 ファイル dos.h 


解脱 は，6つのメモリモデルのすべてにおいて，スタックサイズを示し 

ています。スタックの敢小サイズは128ワードで，これより小さい値を与え 
ると，は自動的に規定の最小値に調整されます。デフォルトのスタ 
ックサイズは 4 K です。 

スモールおよびミデイアムモデルでは，データセグメントのサイズは次の 
ようにして計算されます。 

データセグメント=グローバルデータ+ヒープ+スタック 

ここで，ヒープのサイ ズは heaplen を使って調整することができます。 
タイ ニイ モデルでは，コードも含めたすべてが同一のセグメントに at かれ 
るので，データセグメントは，コードと，ブログラムセグメントブ レフイ 
クス ( PSP ) の256バイトを含む長さに調整されます。 

データセグメント= 256 +コード+グローバルデータ 

+ヒープ+スタック 

コンパクトおよびラージモデルでは， near ヒープは存在しないので，デー 
タセグメントは次のように単純に求められます。 

データセグメント=グローバルデータ+スタック 

ヒュージモデルでは，スタックは別個のセグメントにとられ，各モジ ュー 
ルはモジュールごとにデータセグメントを持ちます。 

参照項目 heaplen 


グローバル 変数 
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timezone 


機能 口ーカル時刻と GMT との差を秒単位で保持しています。 

形式 extern long timezone : 

宜言ファイル time.h 

解脱 timezone は， 時刻日付関数によって使用されます。 

この変数には tzset 関数によって計算された値が人ります。すなわち，ロー 
カル時刻とグリニッジ標準時 ( GMT ) との差を秒単位で表わしたものが, 
long 型の値として代人されます。 


tzname 

機能 時間带名へのポインタの配列です。 

形式 extern char * tzname [2] ； 

宜®ファイル time.h 

解脱 グローバル 変数は，時間带名の略称を含む文字列へのポインタの 

Sti 列です。 

tzname [0]^ TZS 3 境文字列から取り出した地方時間带名の3文字の文字 
列を指しています。 tzname [ l ] l ± % TZ 環境文字列から取り出した复時間地 
方時間带名を表わす3文字の文字列を指しています。炱時間带名が無い場合 
には，む似1/狀[1]はヌル文字列を指します。 

第2章の tzset 関数の解説も参照してください。 
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機能 DOS のバージョン番号を保持しています。 


形式 extern unsigned int version 

宜曾ファイル dos.h 

解脱 version は MS - DOS のバージ ョ ン番号を含んでおり，メジャーバージ ョ 

ンが低位ハ•イトに，マイナー八ージョンが高位バイトに格納されます。 
MS - DOS のバージョン番号”兄/’の x がメジャーバージョン，夕がマイナ 
ーバージョンです。 

これらの変数は， MS - DOS のバージョン2.ズと3.ズの両方で走るモジユー 
ルを必要とする場合に便利です0ライブラリルーチンの中には， MS-DOS 
のバージョンによって動作が異なるものがいくつかあり，バージョン3.ズ 
の下でしか動作しないものもあります（第2章の， open , creatnew , ioctl 
の項を参照してみてください）。 


グローバル 変数 
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第 2 章 


Turbo C ライブラリ 


この章では ， Turbo C ライブラリ中の各関数の詳細な解説を行なっています。 

なお，テキストビデオライブラリ，グラフィックスライブラリ， BIOS サボートライブラ 
リ，日本語処理ライブラリ，サウンドライブラリについては， TurboC 標準ライブラリと 
は別に，それぞれ節をわけて解説してあります。 

次に示したのは，この章をどのように使えばよいかを示すためのサンブルです。 


関数名 

機能 

そのルーチンが何を行なうかの要約です。 

形式 

# include < header . h > 


(ヘッダファイルには，関数のブロトタイブや，その関数で使用される定 
数および列挙型データなどの定義が含まれています。# include 文は，その 
関数の呼び出しに際して必要な場合にのみ示しています)。 


routinevmodirier parameter [, •••]): 


(その関数の宣言の形式です。バラメータ名はイタリック（斜字体）で搿 
かれています。 [,•••] は，それ以降に他のパラメータを指定してもよいこ 
とを示しています)。 

プロトタイプ 

header.h 


(その関数のブロトタイプを含んでいるヘッダファイル名です A いくつか 


クローバル変数 
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の関数のブロトタイブは，複数のヘッダファイルに含まれていますが，そ 
の場合にはそれぞれを記してあります)。 

解脱 ここでは，その関数が何を行なうのか，どのようなバラメータをとるのか, 

また，その関数および関連するルーチンを使用する際に必要となる事柄に 
ついて説明しています。 

戻り値 その関数が返す値がある場合にはここで示します。その関数がグローバル 

変数 errno をセットする場合はそれについても述べます。 

可搬性 その関数を使用できるシステムおよび処理系を示します。これには， 

UNIX , PC -9801 あるいは IBM PC およびその互換機 ， ANSI C などが含 
まれます。 

間連項目 その関数に関連して参照するとよいルーチンを示します。ここにあげた関 

数名にピリオド3つの竹略記号が含まれているときは （ exec •••など），その 
ルーチンはファミリィをなしていることを意味しています。 

例 その関数をどのように使えばよいかを示すサンブルブログラムが載ってい 

るものもいくつかあります。 
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Turbo C 標準関数 リファレンス 


abort 

機能 

形式 

プロトタイプ 

解脱 

戻り値 

可搬性 

関連項目 


ブロセスを輿常終了させます。 

void abortivoid ) : 
stdlib . h , process.h 

abort 関数は，終丫メッセージ (Abnormal program termination ) を stderr 
に出力し，終了コード3で_ exit を呼び出して，ブログラムを興常終了させ 
ます。 

abort そのものには戻り値はありませんが， abort によってブログラムを 
終了させると，親ブロセスまたは DOS に3を返すことになります。 

abort は UNIX システムで使用でき ， ANSI C と互換性があります。 

assert , atexit exit ， exit , raise , signal spawn ." 


Turbo C 標準関数 リファレンス 
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abs 


整数の絶対値を返します。 


機能 

形式 

ブロトタイプ 

解脱 

戻り値 

可搬性 

M 連項目 


# include < math . h > 
int absunt x ) : 

math . h ， stdlib.h 

abs li , 整数引数ズの絶対値を返します。 stdlib . h がインクルードされてい 
るときは， abs はマクロとして扱われ，インラインコードに展開されます。 
abs をマクロではなく関数として扱いたい場合は，ブログラムの中に次の1 
行を入れておきます。 

#undef abs 


これは,# include 〈 stdlib . h 〉 の後に# f いてください。 

abs li , 〇〜32767の範囲の整数を返します。ただし，引数が-32768の場合は 
-32768 が返されます。 

abs は UNIX システムで使用でき ， ANSI C と互換性があります。 

cabs ， fabs , labs 
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absread 


機能 

形式 

プロトタイプ 

解脱 


戻り値 

可撤性 
M 連項目 


デイスクセクタを直接読み込みます。 

int absread (int drive , int nsects ， int Isect ， void * buffer ) : 


dos.h 

absread は，指定されたディスクセクタを読み込みます。これは，ディスク 
の論理的構造を無視し，ファイル， FAT , ディレクトリを考慮しません。 
absread は， DOS 割り込み 0 x 25 を通して，指定したディスクのセクタを読 
み込みます。 

drive = 読み込むドライブ番号 （0 = A ，1 = B ，• • •） 

nsects =洸み込むセクタ数 

Isect =洸み込みを開始する論理セクタ番号 

buffer =洸み込まれるデータが格納される領域の先頭アドレス 

指定されたセクタ数は， buffer が指すセグメント内のメモリ进によって制 
限を受けます。したがって， absread の1回の呼び出しで読み込める最大の 
データ S は 64 K バイトということになります。 

読み込みが成功した場合， absread は0を返します。 

エラーがあった場合は-1を返し， errno にはシステムコールが返した AX 
レジスタの値がセットされます。 errm > の意味については， MS - DOS のブ 
ログラマーズマニュアルを参照してください。 

absread は MS - DOS に特有の関数です。 

abswrite , bios 98 disk , biosdisk 


Turbo C « 準関数リファレンス 
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abswrite 


機能 ディスクセクタに直接害き込みを行ないます。 

形式 int abswrite(int drive , int nsects , int Isect ， void * ouffer ) : 


プロトタイプ dos.h 


解脱 abswrite は，指定されたディスクセクタに褂き込みを行ないます。これ 

は，ディスクの論理的怫造を無視し，ファイル， FAT , ディレクトリを考 
慮しません。 

注意：適切に使用されなかった場合， abswrite は，ファイル，ディレクト 
リ，および FAT を上冉きして壊してしまうことがあります。 

abswrite は， DOS 割り込み 0 x 26 で，指定したディスクのセクタに辨き込み 
を行ないます。 

drive = #き込むドライブ番号 （0 = A , 1 = B , • • •) 

nsects =辨き込むセクタ数 

/sect =冉き込みを開始する論理セクタ番号 

buffer =苒き込まれるデータが格納される領域の先頭アドレス 

辦き込まれるたセクタ数は，•が指すセグメント内のメモリ设によっ 
て制限を受けます。したがって， abswrite の1回の呼び出しで辯き込める最 
大のデータ S は 64 K 八イトということになります。 

戻り値 害き込みに成功した場合， abswrite は0を返します。 

エラーがあった場合は-1を返し， errno にはシステムコールが返した AX 
レジスタの値がセットされます。 errno の意味については， MS - DOS のブ 
ログラマーズマニュアルを参照してください。 

可搬性 abswrite は MS - DOS に特有の関数です。 
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関連項目 


absread , bios 98 disk，biosdisk 


Turbo C 標準関数 リファレンス 
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access 


機能 ファイルのアクセス権を決定します。 

形式 int access (const char * filename , int a mode ): 

プロトタイブ io.h 

解脱 access は，で指定されたファイルをチェックして，そのファイル 

が存在するかどうか，読み込みが可能かどうか，冉き込みが可能かどうか, 
また実行可能かどうかを調べます。 

amode が示すヒ •ッ ト パターンは， 次のような意味を持ちます。 

06 統み込みと苒き込み許可のチヱック 

04 読み込み許可のチヱック 

02 冉き込み許可のチヱック 

01 実行のチェック（無視されます） 

〇〇 ファイルが存在しているかどうかのチェック 

注意： MS - DOS ではすベてのファイルが I 光み込み可能です (amode = 
04)。したがって00と04は同じ結果になります。同様に， MS - DOS では辨き 
込み可能ならば自動的に読み込み可能となるので，06と02は等しい意味を 
持つことになります。 

filename がディレクトリの場合は， access は単にそのディレクトリが存在 
しているかどうかをチェックします。 

戻り値 指定されたァクセス権 （ amo 办に指定した値）が許されている場合は〇を返 

します。そうでない場合は -1 を返し， errno に次のような値をセットしま 
す。 

ENOENT パス名あるいはファイル名が見つからなかった 

EACCES 許可されていない 

48 第2章 Turbo C ライブラリ 


可撤性 access は UNIX システムで使用できます。 

関連項目 chmod , fstat , stat 

例 #include <8tdio.h> 

/include <io.h> 

l * ファイル名が存在すれば 1 を逼し，存在しなければ0を返す*/ 

int file_exi8t8(char *filename) 

< "" 

return (access(filename 9 0 ) — 0 )； 

> 

main() 

{ 

printfCDoes NOTBXIST.FIL exist: Zs¥n B f 

file^existsCHOTEXIST.PIL") ? ■YES 11 : *N0 *)； 

) 

プログラム出力 

Does NOTEXIST^PIL exist: NO 


Turbo C 標準閫数リファレンス 
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acos 


機能 逆余弦を求めます。 

形式 # include < math . h > 

double acos (double x ). 

ブロトタイプ math.h 

解脱 acos は，入力値の逆余弦（アークコサイン）を返します。引数ズは， -1 か 

ら1の間になければなりません。この範囲外の値を引数として与えると， 
acos は0を返し， errno に EDOM (定我域エラー）をセットします。 

戻り値 acos は，〇〜 7 r の値を返します 0 

この関数に対するエラー処理は，関数 matherr を使って変更することがで 
きます。 

可搬性 acos は UNIX システムで使用でき ， ANSI C と互換性があります。 

関連項目 asin ， atan , atan 2， cos , cosh , matherr , sin , sinh ， tan，tanh 
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allocmem 


機能 DOS のメモリセグメントを割り当てます。 


形式 


int allocmem (unsigned size , unsigned * segp ) •, 


プロトタイプ dos.h 


解脱 allocmem は， DOS のシステムコール 0 x 48 を使ってフリーメモリのブロッ 

クを確保し，そのセグメントアドレスを返します。 

size は要求するメモリの大きさ（パラグラフ単位)， segp は新たに割り当て 
られるブロックのセグメントが格納されるワードを指すポインタです。要 
求 M にみあうメモリが残っていない場合には，が砂が指すワードにはアド 
レスは代入されません。 

割り当てられたブロックは，すべてパラグラフ境界に配； K されます。 

戻り偭 allocmem は，メモリブロックの確保が成功した場合には-1を返します。 

allocmem でエラーがあった場合には， doserror と err / io に ENOMEM 
をセットします。 

可搬性 allocmem は MS - DOS 特有のものです。 

関連項目 coreleft , freemem , malloc , setblock 


Turbo C 標準閭数 リファレンス 
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asctime 


機能 日付と時刻を ASCII 文字列に変換します。 

形式 # include く time . h 〉 

cnar 本 asctime (const struct tm * tbiocK) •• 

プロトタイプ time.h 

解脱 asctime は，* tblock 中の構造体として与えられる時刻を， ctime の場合と 

同じ形式の26文字の文字列に変換します。 

Sun Sep 16 01:03:52 1973¥n¥0 

戻り値 asctime は，日付と時刻を持つ文字列を指すポインタを返します 0 この文字 

列は静的データで， asctime の呼び出しが行なわれるごとに上卉きされま 
す。 

可搬性 asctime は，すべての関数は UNIX システムで使用でき， ANSIC と互換 

性があります。 

M 連項目 ctime , difftime , ftime , gmtime , localtime , stime , time , tzset 
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例 


/include <8tdio. 
#include <time.h 


main() 

{ 

struct tm *tm 一 now; 
time_t secs_now ； 
char *str 一 now; 

time(& 8 ec 8 - now )； /* 嵴期を得る（秒単位 ）*/ 

str_now - ctime(& 8 ec 8 _now); /* 文字列に麦換する */ 

printf("The number of seconds since Jan 1,1970 is Zld¥n_• 
8 ec 8 _now) 5 

printf("In other words, the current time is Zs¥n* f str now); 

tm 一 now ■localtime(fcsec 8 _now) ； /* 構造休に賨搶する */ 

printf(•From the structures day Zd Z02d-I02d-Z02d ■ 
•Z02d:Z02d:Z02d¥n' 
tm_now->tm_yday f tm now->tm mon 9 
tm_now->tm_mday t tm 一 now->tm_year • 
tm - now->tm - hour t tm_now->tin min f tm_now->tm_ 8 ec) 5 

str_now - a 8 ctime(tm_now )； /* 構造休から文字列へ */ 

printf(■Once more, the current time is Zs¥n* t 8 tr 一 now)! 


ブログラム出力 

The number of seconds since Jan 1 9 1970 is 315594553 
In other words, the current time is Tue Jan 0112:09:13 1980 
From the structure 1 day 0 00-01-80 12:09:13 

Once more, the current time is Tue Jan 0112:09:13 1980 


Turbo C « 準関数リファレンス 




機能 


逆正弦を求めます。 


形式 # include く math . h 〉 

double asin (double ズ）： 

プロトタイプ math.h 

解脱 asin は，入力値の逆正弦（アークサイン）を返します 0 引数ズは， -1 から 

1の間になければなりません。この範囲外の値を引数として与えると ， asin 
は0を返し， ermo に EDOM (定我域エラー）をセットします。 

戻り値 asin は， - tt /2 〜; r /2 の値を返します 0 

この関数に対するエラー処理は，関数 matherr を使って変史することがで 
きます。 

可搬性 asin は UNIX システムで使用でき ， ANSI C と互換性があります。 

関連項目 acos , atan , atan 2, cos ， cosh , matherr ， sin ， sinh ， tan，tanh 
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assert 


機能 条件によってブログラムを異常終了させます。 

形式 # include < assert . h > 

# include く stdio . h 〉 
void assert (int test ) : 


プロトタイプ assert.h 

解脱 assert は， if 文に展開されるマクロです。引数把 sf が〇 ( 偽）の場合には, 

assert はメッセージをが办ぴに出力し （ abort を呼び出して）ブログラム 
を異常終了させます。 

assert は，次のようなメッセージを出力します。 

Assertion failed: <test> f file <filename>, line <linenum> 

この中で，く test 〉 は引数に指定した条件式， filename と linenum i ±, assert 
マクロが存在するソースファイル名と行番号です。 

ソースコードの中で，# include く assert . h 〉 より前に，# define NDEBUG 
(••デバッグ中ではない”）という指令を龙いておくと， assert マクロはコ 
メントとして扱われ，その部分はコンバイルされません。 

戻り値 戻0値はありません。 

可搬性 assert は，システム III およひを含む何棟類かの UNIX システムで使用 

でき ， ANSI C と互換性があります。 

閲連項目 abort 


Turbo C « 準間数 リファレンス 
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例 


/* ASSERTST.C: リストに追加する項目が NULL かどうか謂べる */ 


/include <as8ert^h> 

/include <8tdio*h> 

/include <8tdlib.h> 

struct ITEM { 
int key; 
int value; 

) 

void additem(struct ITEM *itemptr) 

{ 

assertdtemptr I- HULL); 

/* ••• リストに項目を追加する ••• */ 


main() 

{ 

additem(NULL); 

) 


ブログラム出力 


Assertion failed: itemptr I- NULL, file C : ¥TURBOC¥ASSERT.C t line 13 


atan 


機能 

逆正接を求めます。 

形式 

# include < math . h > 


douole atamdouble x ) : 

ブロトタイプ 

math.h 


解脱 atan は，入力値の逆正接（アークタンジヱント）を返します 0 

戻り値 atan は， -;r/2 〜; r/2 の値を返します 0 

この関数に対するエラー処理は，関数 matherr を使って変吏することがで 
きます。 

可搬性 atan は UNIX システムで使用でき ， ANSI C と互換性があります。 

閧連項目 acos , asin , atan 2, cos , cosh , matherr , sin ， sinh , tan，tanh 


Turbo C 樣準関数 リファレンス 
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atan2 


機能 

形式 

プロトタイプ 

解脱 

戻り値 

可撤性 

関連項目 


y / x の逆正接を求めます。 


# include < math . h > 

double atan 2 (double y y aouble x ) : 

math.h 


atan 2 は，グ / ズの逆正接を返します 0 得られる角度が； r /2 あるいは-; r /2 に 
近い（つまりズが〇に近い）場合でも正しい結果が得られるはずです。 
ズと少がともに0であつた場合， atan 2 は errno に EDOM をセットしま 
す〇 


atan 2 は， ㈣ n 〜 n の値を返します。 

この関数に対するエラー処理は，関数 matherr を使って変更することがで 
きます。 


atan 2 は UNIX システムで使用でき ， ANSI C と互換性があります。 

acos , asin , atan , cos , cosn f matherr , sin , sinh , tan , tanh 
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atexit 


機能 終了時関数を登録します。 

形式 # include < stdlib . h > 

int atexit (atexit t fund )； 


プロトタイプ stdlib.h 

解脱 atexit は， / wnc が指している関数を“終了時関数”として登録します。ブロ 

グラムが正常終了する際に， exit はオペレーティングシステムへ制御を炅 
す前に， （*/ ww )0 を呼び出します。呼び出される関数は加以/し/型で 
す。この型は， stdlib.h の中で typedef 宣言されています。 
atexit が呼び出されるたびに，別の関数が登録されます。肢大32個まで登 
Si することができ，聆後に登録されたものから順に実行されます。 

戻り値 atexit は登録に成功した場合には0を返し，エラーの場合(関数を登録する 

領域が足りないときなど）には0でない値を返します。 

可搬性 atexit は ANSI C と互換性があります。 

閲連項目 abort , exit ， exit ， spawn ... 


Turbo C 標率間数 リファレンス 
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1 called¥n B 


atexit_t exit—fn2(void) 

{ " " 

printf("Exit Function 

> 

main() 

{ 

atexit(exit_fnl )5 

atexit(exit_fn2); 
printf("Main quitting 


プログラム出力 


Main quitting … 

Exit Function 2 called 
Exit Function 1 called 


calledVn 11 )； 


exit_fnl を置鎌 */ 
exit_fn 2 t 幾鎌 */ 
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atof 


機能 文字列を浮動小数点数に変換します。 

形式 # include く math.h〉 

double atof ^const char * j ) : 


プロ トタイプ math.h, stdlib.h 

解脱 atof は， s が指している文字列を double 型に変換します。この関数は，浮 

動小数点数を表現する文字として以下のものを認識します。 

■文字列の前後にあるタブと空白 
■符号 

■数字の並びと小数点（数字は小数点前後にあってもよい） 

■指数部を示す e または E と，それに統く符号つき整数 

変換される文字列は，次の一般形式に沿っていなければなりません。 

[vs](sn J[ddd][.][ddd J[fmt(sn Jddd] 

ここで，⑽はホワイトスペース（空白およびタブ)，功は符号， ddcHi 数 
字の並び， /mf は e または E を示しています。 

atof はさらに， +INF および- INF を正および負の無限大として， +NAN 
および- NAN を非数 (not a number ) として認識します。 
atof は，認識できない文字が現われた段階で変換をやめます。 

戻り値 atof は，入力文字列を変換した結果の値を返します。文字列が double 型の 

数値に変換できない場合には0を返します。 

オーバーフローが 起きた場合には， a t 0 f は正または負の HUGE_VAL を 
返します （ matherr は呼ばれません）〇 

可搬性 atof は UNIX システムで使用でき， ANSI C と互換性があります。 
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atoi 


機能 

形式 

プロトタイプ 

解脱 


戻り値 

可搬性 
閬連項目 


文字列を整数に変換します。 


int atoi (const char * 5) : 


stdlib.h 

atoi は， J が指している文字列を int 型に変換します。この関数は，整数値 
を表現する文字として以下のものを認識します。 

■数字の前後にあるタブと空白 
■符号 

■数字の並び 

変換される文字列は，次の一般形式に沿っていなければなりません。 
( w 8][ sn )[ ddd ) 


ここで， WS はホワイトスペース（空白およひ•タブ)， sn は符号， ddd は数 
字の並びを示しています。 

atoi は，認識できない文字が現われた段階で変換をやめます。 

数値のオーバーフローについては考あされません。 

atoi は，入力文字列を変換した結果の値を返します。文字列が int 型の数値 
に変換できない場合には0を返します。 

atoi は UNIX システムで使用でき ， ANSI C と互換性があります。 

atoi ， atoi , ecvt , fcvt，gcvt 
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atol 


機能 文字列を倍長整数 ( long ) に変換します。 

形式 long atol (const char * s ) : 

ブロトタイプ stdlib.h 

解脱 atol は， s が指している文字列を long 型に変換します。 atol は，整数値を 

表現する文字として以下のものを認識します。 

■数字の前後にあるタブと空白 
■符号 

■数字の並び 

変換される文字列は，次の一般形式に沿っていなければなりません。 
[ w S 】（ Sn 】【 ddd 】 

ここで， ws はホワイトスペース（空白およびタブ)， sn は符号， ddd は数 
字の並ひ•を示しています。 

atol は，認識できない文字が現われた段階で変換をやめます。 

数値のオーバーフローについては考慮されません。 

戻り値 atol は，入力文字列を変換した結果の値を返します。文字列が long 型の数 

値に変換できな v 、場合には0を返します。 

可搬性 atol は UNIX システムで使用でき ， ANSI C と互換性があります。 

関連項目 atof ， atoi ， ecvt , fcvt , gcvt , strtol , strtoul 
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beep (PC-9801 のみ ) 


檐能 

ビープ音を発生させます。 

形式 

void beep (unsigned int time ) \ 

プロトタイブ 

dos.h 

機能脱明 

beep は， sound によって設定されている周期のビープ音を， f / me に指定し 

た繰り返し回数だけ発生させます。 

戻り値 

戻り値はありません。 

可搬性 

この関数は PC -9801 シリーズでのみ動作します。 

間連項目 

sound 

例 

sound ( PC -9801) を参照してください。 
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bdos 


DOS システムコールを実行します < 


形式 


int bdos(int dosfun , unsigned dosdx , unsigned dosal ) 


プロトタイプ dos.h 


解脱 


bdos を使って， DOS システムコールの多くに直接アクセスすることがで 
きます。各システムコールの詳細については， MS - DOS ブログラマーズリ 
ファレンスマニュアルを参照してください。 

引数に整数を必要とするシステムコールの場合は bdos を使用します 0 


ポインタを必要とするシステム コールに ついては， bdos ではなく bdosptr 
を使う必要があるので注意してください。 

引数ゴ oy / wn は， MS - DOS ブログラマーズリファレンスマニュアルで定義 
されているファンクション番号です。 

引数ゴ os ゴズは， DX レジスタの値です。 

引数ゴ 〇^/ は， AL レジスタの値です c 


戻り値 


bdos の戻り値は，システムコールによって AX レジスタにセットされた値 

です 0 


可搬性 


bdos は MS - DOS に特有の関数です。 


関連項目 


bdosptr ， geninterrupt ， int 86, int 86 x , intdos , intdosx 
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例 


# include <stdio. 
/include <dos.h> 


/* カレントドライ’ 

char current 一 dri 

{ " 
char curdriv 

curdrive - b 
return ( f A 9 

} 

main() 

{ 

printf(-The 

> 

プログラム出力 

The current dri 
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bdosptr 



形式 


int bdosptr (int dosfun 、 void * argument , unsigned dosal ) \ 


ブロトタイプ dos.h 


解脱 bdosptr を使って， DOS システムコールの多くに直接アクセスすることが 

できます。各システムコールの詳細については， MS - DOS ブログラマーズ 
リファレンスマニュアルを参照してください。 

ボインタ引数を必要とするシステム コールに ついては bdosptr を使用し 
ます。 

ラージデータモデル（コンパクト，ラージ， ヒュー ジ）では，引数として 
ポインタを必要とするシステムコールに対しては， （ bdos ではなく） 
bdosptr を使わなければなりません。 

引数 dosfurt は， MS - DOS ブログラマーズリファレンスマニュアルで定我 
されているファンクシヨン番号です。 

弓 I 数 argument は ，スモールデータモデルではシステムコールによって使 
用される DX の値，ラージデータモデルでは DS : DX の値を与えます。 

弓 I 数 dosa / は， AL レジスタの値です。 

戻り値 bdosptr は，システムコールが正しく実行された場合には AX の値を返し， 

エラーがあった場合は errno と rfoserrno がセットされます。 

可搬性 bdosptr は MS - DOS に特有の関数です。 

間連項目 bdos , geninterrupt , int 86， int 86 x , intdos，intdosx 

例 harderr を参照してください。 
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brk 


機能 データセグメントのスペース割り当てを変更します。 

形式 int brk (void * addr ) \ 

プロトタイプ alloc.h 

解脱 brk は，呼び出したブログラムのデータセグメントに割り当てられている 

メモリ領域の大きさを，動的に変吏す る 際に使用します。変更は，プ ログ 
ラムの“ ブレーク 値 •’を 再設定す る ことによって行ないます。 ブレーク 値と 
は，データセグメントの般後のすぐ後ろのアドレスです。割り当てられる 
領域は， ブレーク 値の增加にしたがって增加します。 
brk は， ブレーク 値に addr をセットし ，これに従って割り当て スペースを 
変更します。 

システムで許される大きさを越えるスペースを確保しようとした場合には 
エラーとなり，割り当てスペースの変更は行なわれません。 

戻り値 割り当てスペースの変更に成功した場合， brk は0を返します。 

変史できなかった場合には -1 を返し， eir / io を次の値にセットします。 

ENOMEM メモリが不足した 

可搬性 brk は UNIX で使用できます。 

M 連項目 coreleft , sbrk 
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bsearch 


機能 配列内のバイナリサーチ（二分探索）を行ないます。 

形式 # include く stdlib.h 〉 

void * bsearch (const void * key , const void * base , 

size t nelem t size t width , 

int (木 fcmp ) (const void * ， const void 本））： 

プロトタイプ stdlib.h 

解脱 bsearch は，メモリ上の/個の要素を持つテーブル （ fiii 列）内を検索 

し，検索キーに一致した®初の項目のアドレスを返します。一致する瑣目 

がなかった場合は0を返します。 

size f は， unsigned int として定義されています。 

テーブルの中の項目は， bsearch を呼び出す前に昇順にソートされていな 
ければなりません。 

驅 nelem には， テーブル中の要素の個数を与えます 0 
驅 width には， テーブル中の1つの要素のバイト数を指定します。 

fcmp は、 ユーザが定義する比較ルーチンを指すポインタです。比較ルーチ 
ンは， eleml と の2つの引数をとります〇 2つの引数はそれぞれ比較さ 
れる値を指します。比較関数は，2つの引数が指す項目 （* elemU * e lem 2) 
を比較し，その結果にしたがって整数値を返します。 

* fcmp の戻り値は次のようになります。 


■ * eleml < * elem 2 の場合，0より小さい値 

■ * eleml = = * elem 2 の場合，0 

■ * eleml > * elem 2 の場合，0より大きい値 


通常は， eleml は引数んひで， elem 2 は検索の対象となるテーブル内の項目 


を指します。 
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fcmp が検索 キー やテーブルの項目をどのように解釈するかは自由であり， 
ユーザが必要とする方法で定義することができます。 
bsearch は，テーブル中を検索するために， /cm/? が指すアドレスにあるル 
ーチン（比較関数）を繰り返し呼び出すことになります。 

戻り値 bsearch は，テーブル内で検索キーと一致した最初の項目のアドレスを返 

します。一致する項目がなかった場合には0を返します。 


可搬性 bsearch は UNIX システムで使用でき ， ANSI C と互換性があります。 

関連項目 lfind ， lsearch , qsort 

例 # include <stdio.h> 

#include <stdlib.h> 

#define NELEMS(arr) (sizeof(arr) / sizeof(arr[0])) 
int numarray[] _ { 123,145, 512, 627, 800 9 933 >; 


int numeric(int *pl t int *p2) 

{ 

return(*pl - *p2 )； 

) 

I* テーブル内のキーであれば 1, そうでなければ 0 を返す */ 
int lookup(int key) 

{ 

int ♦itemptr; 

I* bsearchOtt, 見つかつた項目へのポインタを返す */ 

itemptr - (int *) bsearch(&key f numarray f NELEMS(numarray) f 

sizeof(int)• nomeric )5 
return (itemptr I- NULL); 


main() 

{ 

printfCIs 512 in table? 

printfCZ8¥n* f lookup(512) ? -YES" : •NO *)； 


プログラム出力 


Is 512 in table? YES 
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cabs 


機能 複素数の絶対値を返します。 

形式 # include < math . h > 

double cabs (struct complex z ) \ 

プロトタイプ math.h 

解脱 cabs は，複素数 z の絶対値を計算するマクロです。 z は complex 型の構造 

体です。この榷造体は， math . h の中で次のように定義されています。 

struct complex { 
double x 9 y; 

ズが実数部，夕が虚数部です。 

cabs の呼び出しは， 2 の実数部と虛数部を次のようにして sqrt を呼び出す 
ことと同じになります。 

8qrt(z.x * z.x + z.y * z.y) 

cabs を，マクロではなく関数として扱いたい場合は，ブログラムに次の1行 
を*いてください。 

rundet caD8 

戻り値 cabs は， z の絶対値を double 型で返します。オーバーフローがあった場合 

は HUGE_VAL を返し， errm > に ERANGE (結果が指定の範囲を越えた） 
をセットします。 

cabs のエラー処理は， matherr 関数を使って変更することができます。 
可搬性 cabs は UNIX システムで使用できます。 

閲連項目 abs , fabs , labs , matherr 
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calloc 


機能 メインメモリを割り当てます。 

形式 # include < stdlib . h > 

void * calloc (size t ruterns , size t size ) : 


プロトタイプ stdlib . h , alloc.h 

解脱 calloc は， C のメモリヒーブへのアクセスを提供します。ヒープは，可変サ 

イズのメモリブロックの動的割リ当てに使用することができます。木構造 
や線形リストなど多くのデータ構造は，通常このヒープ領域に遛かれます。 
スモールデータモデル（タイ ニイ， スモール，ミディアム）では，データ 
セグメントの終わりからブログラムスタックの先頭までをヒープとして使 
用することができます。ただし，スタックの先頭の直前256バイトは，アブ 
リケーシヨン用のスタックの拡張領域と MS-DOS が使用する領域として 
確保されているため除外されます。 

ラージデータモデル（コンパクト，ラージ，ヒュージ）では，ブログラム 
スタックを越えて，メモリの物理的な最終位3¢までヒープとして使用可能 
です 。 

calloc は，サイズ nitems x size のブロックを確保します。ブロック中の各バ 
イトはゼロクリアされます。 

戻り値 calloc は，新たに確保されたブロックを指すポインタを返します。メモリ 

が不足してブロックを確保できなかった場合，あるいは nitems また li size 
が0だった場合には NULL を返します。 

可搬性 calloc は UNIX システムで使用でき， ANSI C と互換性があります。 K & 

R でも定義されています。 

関連項目 farcalloc , free , malloc . realloc 
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ceil 


機能 小数点以下の切上げを行ないます。 

形式 # include く math.h 〉 

double ceil (double x ) : 

プロトタイプ math.h 

解脱 ceil は，ズを下まわらない最小の整数を返します。 

戻り値 ceil は，上で述べた整数を double で返します。 

可搬性 ceil は UNIX システムで使用でき ， ANSI C と互換性があります。 

間連項目 farcalloc , free , malloc , realloc 
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cgets 


機能 コンソールから文字列を読み込みます。 

形式 char * cgets(char * str) : 

プロトタイプ conio.h 

解脱 cgets は，コンソールから文字の列を読み込み，その文字列（およびその長 

さ）をが r が指す場所に格納します。 

cgets は， CR / LF に出会うまで，または最大文字数まで文字を説み込みま 
す。 CR / LF を説むと， cgets は CR / LF を¥0(ヌル文字）に iS き換えてか 
ら格納します。 

cgets を D ’ f •び出す前に， wCo ] には说み込む文字列の股大反を入れておく必 
要があります。 c K ets の実行が終わると， wr [ l ] に実際に洸み込まれた文字 
数がセットされています。洸み込まれた文字は价 [2] から始まり，ヌル文字 
で終わリます。したがってが r の長さは，骹低於 r [0]+2 ハ•イトある必要が 
あります。 

戻り値 成功した場合， cgets は&价[2]，つまり統み込まれた文字列の先頭を指す 

ポインタを返します。エラー戻りはありません。 

可搬性 cgets は PC -9801 シリーズ（またはグラフィックスディスブレイアダプタ 

を備えた IBM PC およびその互換機）でのみ動作します。 

閲連項目 fgets , getch ， getche，gets 
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#include <8tdio.h> 
#include <conio.h> 


main() 

{ 

char buffer[82]; 
char *p ； 

bu£fer[0] - 80 ; /* 80 文字分のスペース */ 

p - cgets(buffer) ; 

printf("Vncgets got Zd characters: ¥*Z8¥*¥n e f buffer[l) t p )； 
printfCThe returned pointer is Zp 9 buffer[2 】 is at Zp¥n_• 
p» &buffer); 

bufferfOJ - 5; /* スペースを 5 文字分だけにする */ 

P - cget8(buffer)s 

printf(■¥ncgets got 2d characters: ¥*Zs¥*¥n* t buffer[l] t p) : 
printf("The returned pointer is Ip 9 buffer[2] is at Ip¥n* f 
p # &buffer); 


ブログラム出力 


abcdefghijflm 

cgets got 12 chare i *abcdefghijklm" 

The returned pointer is FEP6 f buffer 【 2】 is at FEP6 
abed 

cgets got 4 charactersi •abed* 

The returned pointer is PEF6 t buffer[2] is at PBF6 
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chdir 


機能 

形式 

プロトタイプ 

解脱 


戻り値 

可撤性 

M 連項目 


カレントディレクトリを変更します。 
int chdir (const char * path ) : 

dir.h 

chdir は， path で指定したディレクトりを，現在の作業ディレクトリにし 
ます。 pflrA は実際に存在するディレクトリでなければなりません。 

パ / A の中には，次のようにドライブ名を含めることもできます。 

chdir(*a:¥¥turboc*) ; 

ただしこの場合，指定ドライブのカレントディレクトリが変更されるだけ 
で，カレントドライブは変更されません。 

変史に成功すれば0を返します。そうでなければ -1 を返し， err/io を次のよ 
うにセットします。 

ENOENT バス名またはファイル名が見つからない 
chdir は UNIX システムで使用できます。 

getcurdir , getcwd , mkdir , rmdir , system 
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機能 ファイルのアクセスモードを変更します。 


形式 # include < dos . h > 

# include < io . h > 

int chmod(const char * path ,int func [,int attrio ]) : 

プロトタイプ io.h 

解脱 _chmod は， DOS のファイル属性の統み出しまたは設定を行ないます 0 

func が0の場合， chmod は path に指定したファイルの現在の DOS «性 
を返します。 / wm : が1の場合には，城性を⑽必で指定した値に設定しま 
す。 

attrib は， 以下に示すシンボリック定数 （ io . h の中で定我されています）の 
いずれかです。 

FA_RDONLY 统み出し埤用 
FA HIDDEN 隠しファイル 
FASYSTEM システムファイル 

戻り値 chmod は，成功した場合はファイル«性ワードを返し，そうでなければ 

-1 を返します。 

エラーの場合， errm > に以下の値のいずれかがセットされます。 

ENOENT ハ。ス名またはフアイル名が見つからない 

EACCES アクセスは許可されていない 

可撤性 chmod は MS - DOS に特有なものです。 

間連項目 chmod，creat 
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chmod 


機能 

形式 

プロトタイプ 

解脱 


戻り値 


可搬性 

関連項目 


ファイルのアクセスモードを変史•します。 


# include < sys ¥ stat . h > 

int chmocUconst char 本 path ， int a mode ) : 


io.h 


chmod は， path によつて与えられるファイルのアクセス許可を， amode で 
指定されたマスクにセットします。 path は ，ファイル名を含む文字列を指 
します。 

amode ( i , SJWRITE , S _ IREAD ( sys ¥ stat.h の中で定我されています） 
のいずれか，または_方を持つことができます。 


amode の値 アクセス許可 


S IWRITE 冉き込み可 

SJREAD 說み出し可 

S IREAD ! S IWRITE 說み出し/冉き込み可 


chmod は，ファイルアクセスモードの変史に成功した場合は0を返し，そう 
でなければ -1 を返します。 

エラーの場合， err / io に以下の値のいずれかがセットされます。 

ENOENT ハ•ス名またはファイル名が見つからない 

EACCES アクセスは許可されていない 


chmod は UNIX システムで使用できます。 


access ， chmod ， fstat , open , sopen，stat 
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/include <8tdio.h> 

#include <sys¥8tat.h> 

#include <io.h> 

void make 一 read 一 only(char *filename) 

{ 

int stat ； 

stat _ chmod(filename, S IREAD); 
if (stat) 

printfCcouldn f t make 2 s read-only¥n" # 
else 

printf("made 2s read-only¥n # t filename) 

> 

main() 

< 

make_read_only( ■NOEXIST-PIL*) 5 
make_read_only( ■MYFILE.FIL*); 


ブログラム出力 


couldn’t make NOEXIST.PIL read-only 
made MYFILE.FIL read-only 


filename) 5 
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chsize 


機能 ファイルサイズを変更します 0 

形式 int chsize (int handle ，long size ) : 

プロトタイプ io.h 

解脱 chsize は，に対応するファイルの大きさを変更します 0 • size の値 

と，ファイルの最初の大きさとの関係によって，ファイルの一部を切り捨 
てるか，大きくするかが決まります。 

オーブンするファイルのモードは，宵き込み可能でなければなりません。 
chsize がファイルを大きくするときには，ヌル文字 （¥0) を追加します。 
ファイルを切り捨てる場合は，新しいファイルの終わり以降の文字は失わ 
れます。 

戻り値 chsize は成功すれば0を返します。失敗した場合は - 1を返し， errm > に次の 

いずれかをセットします。 

EACCESS アクセスが拒否された 

EBADF ファイル番号が正しくない 

ENOSPC UNIX である 一 DOS ではない 

可撤性 chsize は MS - DOS に特有の関数です。 

W 連項目 close , creat , creat , fopen 
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clear87 

機能 浮動小数点ステータスワードをクリアします。 

形式 unsigned int _ clear 87( void ) : 

ブロトタイプ float.h 

解脱 _ clear 87 は，浮動小数点ステータスワードをクリアします。浮動小数点ス 

テータスワードは，8087/80287ステータスワードと，8087/80287例外ハン 
ドラによって検出された他の条件からなるものです。 

戻り值 返される値の ビッ トハ•ターンは，浮動小数点ステータスワードを示して い 

ます。ステータスワードの詳細については， float . h で定義されている定数 
を参照してください。 

閲連項目 control 87, fpreset , _ status 87 

例 controI 87 を参照してください。 
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clearerr 


概能 エラー 状態をリセットする 

形式 # include く stdio . h 〉 

void clearerr (FILE * stream ) : 


プロトタイプ stdio.h 


解脱 clearerr は， stream に指定されたのエラー標識とファイル終了標識を0に 

します。 

エラー標識がセットされると， clearerr または rewind の呼び出しが行な 
われるまで，そのストリームに対する操作は常にエラーを返します。 
ファイル終了標識は，人力操作によってリセットされます0 

戻り値 戻り値はありません。 

可撤性 clearerr は UNIX システムで使用でき ， ANSI C と互換性があります 0 

関連項目 eof , feof , ferror , perror , rewind 


Turbo C « 準関数 リファレンス 


83 






clock 


機能 

形式 

プロトタイプ 

脱明 

戻り価 

可搬性 

例 


プロセッサ時間を得ます。 


# include <time.h> 
clock t clock (void) : 

time.h 

clock は， 2 つのイベントの間の時間を測定するのに使うことができます。 
その時間を秒単位で表現するには， clock が返した値を マクロ CLK TCK 
で割る必、要があります。 

clock は，ブログラムの開始から辁過したブロセッサ時間を返します。ブロ 
セツサ時間が得られない，あるいはその値が表現不可能の場合は，関数は 
-1 を返します。 


clock は ANSI C と互換性があります。 


# include <time.h> 
#include < 8 tdio.h> 


void maln() 

{ 

clock_t 8 tart, end; 
start _ clock (>； 

/* WW を * るコードがここに入る */ 
end - clock () ； 

printf("The time was s If¥n* t (end • start) / CLK TCK )5 
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close 


ファイルをクローズします。 


機能 

形式 

プロトタイプ 

解脱 


戻り値 

可搬性 

間連項目 


int close(int handle) \ 
io.h 

close は， handle に結ひ•つけられているフアイルをクローズします。 

handle は， creat, creat, creatnew, creattemp, dup, dup2, 
open, open の呼び出しによつて得られたフアイルハンドルを持っていま 
す0 


注意： close は，ファイルの最後に CTR し Z (Oxla) を搿き込みません。 
ファイルの最後に CTR し Z が必要であれば，クローズする前になんらかの 
方法で冉き込んでおかなければなりません。 


クローズに成功した場合は0を返し，そうでなければ -1 を返します。 
handle が有効なオープンフ了イ ルでなかった場合には エラーと なり, 
err/io に次の値がセットされます。 

EBADF ファイル番号が正しくない 

close は MS-DOS 特有のものです。 

close， creat, open, read, write 
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close 


機能 ファ/ 

形式 int cl 



ローズします。 
handle ) \ 




す 0 handle li 9 cerai , create creatnew , creattemp , dup , dup 2, 


open , open の呼び出しによって得られたファイルハンドルです。 


注意： close は，ファイルの煅後に CTR し Z ( Oxla ) を冉き込みません。フ 
ァイルの敢後に CTR し Z が必要であれば，クローズする前になんらかの方 
法で# f き込んでおかなければなりません。 


戻り値 クローズに成功した場合は0を返し，そうでなければ -1 を返します。 

が有効なオーブンファイルでなかった場合にはエラーとなり, 
errno に次の値がセットされます。 


EBADF ファイル番号が正しくない 


可搬性 close は UNIX システムで使用できます。 


fta 連項目 chsize , close , creat ， creatnew , dup , iclose , open，sooen 
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control87 


機能 浮動小数点制御ワードを操作します。 

形式 unsigned int _ control 87 (unsigned int new , unsigned int mask ) : 

プロトタイプ float.h 

解脱 control 87 は，浮動小数点制御ワードの取りだし，または変更に使用しま 

す。 

浮動小数点制御ワードは， unsigned int で，ビットごとに浮動小数点パッ 
ケージのモードを示すようになっています。モードには，精度，無限値や 
丸めの取り扱いなどがあります。こうしたモードを変更することによって, 
浮動小数点の例外処理をマスクしたり，アンマスクしたりすることができ 
ます。 

control 87 (±, mask の各ビットを new の各ビットに対応させます。 mask 
のビットが1の場合， new の対応するビットが，浮動小数点制御ワードの同 
じビットの新しい値を示すことになり，制御ワードにはこの新しい値がセ 
ットされます。 

以下は，この動作の例です。 

元の M 御ワード： 0100 00110110 0011 

mask : 1000 000101001111 
newvals : 111010010000 0101 

寳更されるビット * lxxx xxxl xOxx 0101 

mask が 0 の場合， control 87 は浮動小数点制御ワードを変更せずに返しま 
す。 

戻り値 返される値のビットパターンは，浮動小数点制御ワードの新しい値を表わ 

しています。 _ control 87 が返すビットパターンの詳細な定義については， 
float . h を参照してください。 
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関連項目 


clear87 ， fpreset ， signal ， status87 

例 #include <math.h> 

#include <float.h> 

#include <8tdio.h> 

#difine CW_HEW (CW_DEFAULT | EM_ZBRODIVIDE | EM^OVERFLOW) 
Idefine MASK_ALL (OxFFFF) 

main() 

{ 

float a» b, c; 

_control87(CW 一 NEW|EM 一 INVALID, MASK ALL); 
a - 1.0; 
b - 0.0; 
c - a/b; 

if(_8tatus87() & SW_ZERODIVIDE) 

{ ~ 

fprintf(8tderr f "DIVISION BY ZERO.¥n*)? 

_clear87(>: 
return(l )； 

) 
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coreleft 


機能 

形式 

プロトタイプ 

解脱 

戻り値 

可搬性 

関連項目 


未使用メモリの s を調べて返します。 

•タイニィ，スモール，ミディアムモデルの場合 
unsigned coreleft (void) : 

•コンバクト，ラージ，ヒュージモデルの場合 

unsigned long coreleft (void) : 
alloc.h 

coreleft は，未使用のメモリ ft 返します。返される値は，メモリモデルが 
スモールデータモデルか，ラージデータモデルかによって異なります。 

ラージデータモデルでは，ヒープとスタックの問の未使用メモリの: Ift を返 
します。 

スモールデータモデルでは，スタックとデータセグメントの間の未使用メ 
モリの燉から256ハ•イトを引いた値を返します。 

coreleft は MS - DOS に特有の関数です。 

allocmem , brk , farcoreleft , malloc 
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機能 


余弦を求めます。 


形式 # include く math.h〉 

double cos (double x ) : 

プロトタイプ math.h 

解脱 cos は，入力値の余弦（サイン）を返します。角度ズはラジアン単位で指定 

します。 

戻り値 cos は， -1 から1の範囲で値を返します。 

この関数に対するェラー処理は，閲数 matherr を使って変吏することがで 
きます。 

可搬性 cos は UNIX システムで使用でき ， ANSI C と互換性があります。 

関連項目 acos, asin, atan，atan2, cosh, matherr, sin, sinh, tan, tanh 
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cosh 


機能 双曲線余弦を求めます。 

形式 # include <math.h> 

double cosh (double x ) : 

プロトタイプ math.h 

解脱 cosh は，実数引数に対する双曲線余弦（ハイハ•ボリックサイン）を計算し 

ます。 

戻り値 引数の双曲線余弦を返します。 

計算結果がオーハ•ーフローしてしまう場合には， cosh は適切な符号をつけ 
た HUGE VAL を返し， errno に ERANGE をセットします。 

このルーチンのエラー処理は， matherr 関数を通じて変更することができ 
ます。 

可搬性 cosh は UNIX システムで使用でき ， ANSI C と互換性があります。 

関連項目 acos , asin ， atan ， atan 2， cos , matherr , sin , sinh ， tan，tanh 
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country 

機能 国別情報を返します。 

形式 # include <dos.h> 

struct country * country (int xcode, struct country * cp); 

プロトタイプ dos.h 

解脱 country は，国別情報（日付，時刻，通货など）をどのような冉式で表現 

するかを指定します。この関数によってセットされる値は，使用している 
MS-DOS のバージョンによって異なります。 

印 の値が-1であると，現在の国は xcode の値にセットされます。 xcode は 
0 であってはなりません。印が- 1 以外の場合には， cp が指す構造体 coun - 
try が，以下のいずれかの悄報で埋められます。 

■現在の国 ( xcode が Q の場合) 

■ xcode で指定された国 

構造体 country は， dos.h の中で以下のように定義されています。 

struct country { 
int co_date ； 
char co_curr[5 ]5 
char co_th 8 ep[ 2 ]; 
char co_de 8 ep[ 2]5 
char co_dt 8 ep[ 2 ]; 
char co_tm 8 ep( 2 ]; 
char co 一 currstyle 
char co_digits; 
char co—time; 
long co 一 case; 
char co_dasep; 
char co_fill( 10 ]； 


/* 日付書式 */ 

/* 通貨記号 */ 

/* 3 桁ごとの区切り記 #*/ 

/* 10 遵败分!■記溽 */ 

/* 日付分■記号 */ 

/* 轉 « 分！■記号 */ 

/* 通貨の形式 */ 

/* 通貨の桁败 */ 

/* 形式 *1 

/* ケースマップ */ 

/* データの区切り記号 */ 
/* フイラ（埋める文字 ） *1 


}； 



CO date の只 付害式は，次のようになります。 


0 米国式（月-日-年） 

1 欧州式 （ H - 月-年） 

2 日本式（年-月-日） 

co currstyle が示す通«表示形式は，以下のようになります。 

0通«記号は数値の前，通«記兮と数値の間には空白なし 
1通貨記号は数値の後ろ，通货記号と数値の間には空白なし 
2通«記号は数値の前，通«記号と数値の間に空白1個 
3通貨記号は数値の後ろ，通»記号と数値の間に空白1個 

戻り値 成功すれば， country はポインタ引数 cp を返します。エラーがあった場合 

には NULL を返します。 

可搬性 country は MS-DOS 3.0 以降で使用できます。 
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cprintf 

機能 画面に害式つき出力を行ないます。 

形式 int cprintf (const char + format [, argument ,...]) : 

ブロトタイブ conio.h 

解脱 cprintf は， / o / w 如によって指される害式文字列中の書式指定を ， format 

の後に続く各引数に適用し，讲式化されたデータを画面上のカレントテキ 
ストウインドウに直接出力します。咨式指定は，後に絞く引数と同じ数だ 
けなければなりません。 

冉式指定に関する詳細な悄報については， printf の解説を参照してくださ 

い0 

cprintf は， printf および fprintf とは異なり，改行文字 （¥ n ) を復帰改 
行ベア （¥ r ¥ n ) に変換しません。 

戻り 値 cprintf は，出力した文字数を返します。 

可搬性 cprintf は PC -9801 シリーズ（または IBM PC とその互換機）でのみ動作 

します。 

関連項目 rfirec か irfeo (変数)， fprintf ， printf ， putch , sprintf，vprintf 

例 printf を参照.してください。 
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cputs 


機能 画面に文字列を出力します。 

形式 int cputs (const char * str ) \ 


プロトタイブ conio.h 


解脱 cputs は，ヌルで終わる文字列灯/•を，カレントテキストウインドウに擗き 

ます。 m 改文字は付加されません。 

PC -9801 では，文字列は直接テキスト VRAM に冉き込まれます 。 IBM PC 
の場合には，グローバル変数 directvideo の値によって，画面メモリに直 
接冉き込まれるか， BIOS を通じて出力されるかが決まります。 
cputs は， puts とは異なり，改行文字 (¥ n ) を復帰改行ペア （¥ r ¥ n ) に 
変換しません。 

戻り値 cputs は， S 後に冉いた文字を返します。 

可撤性 cputs は PC -9801 シリーズ（または IBM PC とその互換機）でのみ動作し 

ます。 

閫連項目 directvideo (变致）， putch，puts 
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機能 新しいファイルを作成する，あるいは既存のファイルを害きなおします。 

形式 # include < dos . h > 

int —creat (const char * path , int attrib ) \ 

ブロトタイプ io.h 

解脱 _creat は，新しいファイルを作成するか，あるいはすでに存在するファイ 

ルを供きなおすための準備を行ないます。作成または冉きなおされる ファ 
イルは， paM によって与えられます。 

creat li , DOS の属性ワード attrib を引数にとります。 creat の呼び出し 
では，どの«性ビットもセットすることができます。ファイルは，常にバ 
イナリモードでオーブンされます。ファイルの作成に成功すれば，ファイ 
ルボインタはファイルの先頭にセットされます。ファイルは，読み込み/冉 
き込み可でオーブンされます。 

ファイルがすでに存在している場合，そのサイズは〇にリセ ッ トされます 
(これは，そのファイルを削除してから同じ名前で新たに作成するのと， 
基本的には同じことです)。 

_creat に渡す引数 a び/*は， ( dos.h で定義されている）以下のいずれかの 
値をとることができます。 

FA_RDONLY 読み出し専用属性 

FA HIDDEN 隠しファイル 

FA SYSTEM システムファイル 
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戻り値 動作に成功した場合， creat は新しいファイルハンドル（負でない整数) 

を返し，エラーの場合には -1 を返します。 

エラーがあった場合， errno には次の値のいずれかが セッ トされます。 

ENOENT ハ•ス名またはファイル名が見つからない 

EMFILE オーブンフアイルが多すぎる 

EACCES アクセスは許可されていない 

可撤性 creat は MS - DOS に特有の関数です。 

fkl 連 I 貝目 chmod , chsize , close , close , creat , creatnew , creattemp 
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機能 


新しいファイルを作成する，あるいは既存のファイルを書きなおします。 


形式 # include < sys ¥ stat . h > 

int creat (const char * path , int amode )； 

プロトタイプ io.h 

解脱 creat は，新しいファイルを作成するか，あるいはすでに存在するファイル 

を害きなおすために使用します。ファイル名は， p 如 A が指す文字列です。 
amode は， ファイルを新たに作成するときにのみ用いられます。 
creat によつて作成されるファイルは，常にグローバル変数—/) node によ 
つて指定される変換モード （0 _TEXT または0 BINARY ) で作成されま 
す。 

ファイルがすでに存在していて，冉き込み域性がセットされている場合に 
は， creat はそのファイルのサイズを〇にして，械性はそのまま変史しませ 
ん。すでに存在しているファイルが统み出し坪用«性であると， creat の呼 
び出しはエラーとなり，そのファイルは変更されません。 
creat の呼び出しでは，アクセスモードワード amode 内の S IWRITE ビ 
ットのみが調べられます。このビットが1であれば，そのファイルは讲き込 
みが可能です。このビットが〇であれば說み出し珲用になります。これ以外 
の DOS の域性は，すべて0にセットされます。 

麵办 には，以下の値のいずれかを指定します （ sys ¥ stat . h の中で定義さ 


れています)。 


amode の値 

アクセス許可 

SJWRITE 

害き込み可 

S 一 IREAD 

読み出し可 

S IREAD ! S IWRITE 

読み出し/害き込み可 
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戻り値 


可撤性 

関連項目 


注意： MS-DOS では，害き込み可であれば同時に読み出しも可になりま 
す 〇 


動作に成功した場合には，新しいファイルハンドル（負でない整数）が返 
され，エラーの場合には -1 が返されます。 

エラーがあった場合， errno には次のいずれかの値が セッ トされます。 

ENOENT ハ•ス名またはファイル名が見つからない 

EMFILE オーブンされているファイルが多すぎる 

EACCES アクセスは許可されていない 

creat は UNIX システムで使用できます。 

chmod , chsize , close , create , creatnew , creattemp , dup , dup 2, 
/•morfe (変数）， fopen , open , sopen , write 
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creatnew 


機能 新しいファイルを作成します。 

形式 # include < dos . h > 

int creatnew (const char 本 path , int attrib ) \ 

プロトタイプ io.h 

解脱 reatnew は， _ creat とほとんど同じです。異なる点は，指定したファイル 

がすでに存在している場合には creatnew の呼び出しはエラーとなり，そ 
のファイルは変化を受けないということです。 

creatnew の引数 attrib には， ( dos.h の中で定義されている）以下に示す定 
数のいずれかを指定します。 

FA_RDONLY 読み出し專用 

FA_HIDDEN 隠しファイル 
FASYSTEM システムファイル 

戻り値 動作に成功した場合には，新しいファイルハンドル（負でない整数）が返 

され，エラーの場合には -1 が返されます。 

エラーがあった場合， errm > には次のいずれかの値が セッ トされます。 

EEXIT すでにファイルが存在する 

ENOENT パス名またはファイル名が見つからない 

EMFILE オーブンされているファイルが多すぎる 

EACCES ァクセスは許可されていない 

可搬性 creatnew は MS-DOS 3.0 に特有の関数で，それより前のバージョンの 

DOS では動作しません。 

関連項目 close ， creat ， creat ， creattemp , dup ， fmorfe (変数 ）， open 
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creattemp 

機能 指定されたディレクトリ中にユニークなファイルを作成します。 

形式 # include <dos.h> 

int creattemp (char 本 path , int attrib ) \ 

プロトタイプ io.h 

解脱 creattemp によって作成されるファイルは，常にグローバル変数 fmode 

で指定されている変換モード （ OTEXT または OBINARY ) で作成され 
ます。 

引数 parA はパス名で，最後に円記号 （¥) をつけます。 part に指定された 
ディレクトリの中でユニークな（存在するどのファイルとも一致しない） 
適当なファイル名がつけられます。作成されたファイル名は path が指す場 
所におさめられます。 pa 泊は ，結果となるファイル名を格納するのに充分 
な大きさがなければなりません。作成されたファイルは，ブログラムが終 
了するときに，自動的に削除されるということはありません。 
creattemp は， DOS の属性ワード attrib を引数にとります。 creat の呼び 
出しでは，どの属性ビットもセットすることができます。ファイルは，常 
にバイナリモードでオーブンされます。ファイルの作成に成功すれば，フ 
ァイルポインタはファイルの先頭にセットされます。ファイルは，読み込 
み/書き込み可でオーブンされます 0 

attrib には， 以下に示す定数のいずれかを指定します（これらは dos.h の中 
で定義されています)。 

FA RDONLY 読み出し専用 

FA HIDDEN 隠しファイル 

FA SYSTEM システムファイル 
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戻り値 


動作に成功した場合には，新しいファイルハンドル（負でない整数）が返 
され，エラーの場合には -1 が返されます。 

エラーがあった場合， errrn ) には次のいずれかの値が セッ トされます。 


ENOENT パス名またはフアイル名が見つからない 

EMFILE オーブンされているフアイルが多すぎる 

EACCES アクセスは許可されていない 

可撤性 creattemp は MS . DOS 3.0 に特有の関数で，それより前のバージヨンの 

DOS では動作しません。 

関連項目 close , creat , creat ， creatnew , dup ， (変数 ）， open 
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cscanf 


機能 コン ソールから 書式つき入力を行ないます。 

形式 int cscanf (char * format [ f address ,...]) : 

ブロトタイプ conio.h 


解脱 cscanf は，一連の入カフィールドをスキャンして，一度に1文字ずつコンソ 

ールから直接文字を說み込みます。次に，引数 format によって指される辨 
式文字列中の#式指定にしたがって，各フィールドを漭式化します。煅後 
に， / orm 似の後に統く各引数が示しているアドレスに，害式化した入力を 
格納していきます。入力は画面に直接エコーされます。搿式文字列中の冉 
式指定の個数は，その後に統くアドレスの数と同じでなければなりません。 
并式指定も含めて，詳細な情報については 8 canf の解説を参照してくださ 

い。 

cscanf は，通常のフイールドの終了（ホワイトスペース）に達する前に， 
フイールドのスキャンをやめる場合があります。また，いくつかの理由か 
ら入力を終了してしまうこともあります。こうした問題については scanf 
の解説を参照してください。 

戻り値 cscanf は，正しくスキャンし，変換し，格納できた入カフィールドの数を 

返します。戻り値には，値が格納されなかった入カフィールドの数は含ま 
れません。値が格納されたフィールドがなかった場合は，戻り値は〇になり 
ます。 

cscanf がファイルエンドを說み込もうとした場合，戻り値は EOF になり 
ます。 

可搬性 cscanf は UNIX システムで使用でき， K & R で定義されています。 

関連項目 fscanf ， getche , scanf，sscanf 
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ctime 


機能 

形式 

ブロトタイプ 

解脱 


戻り値 

可撤性 

関連項目 

例 
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H 付と時刻を文字列に変換します。 


# include < time . h > 

cnar * ctime (const time t * time ) \ 


time.h 


ctime は， time が指している時刻値 ( time 関数などによって返されたもの) 
を，次のような煅後に改行とヌル文字のついた26文字の文字列に変換しま 

to 


Hon Nov 2111:31:54 1983¥n¥0 


各 フイ ー ル ドの幅は固定です。 

long 型の グローハ 数は， GMT とその地方の標咿時の差を 
秒単位で保持しています （ PST — 太平洋棵準時の場合には 8 X 60 X 60) 。 グ 
ローバル変数 daylight li , 米国の*:時間の期間中にのみ〇以外の値をとる 
ようになっています。 


ctime は，日付と時刻を持つ文字列を指すポインタを返します。戻り値は静 
的データを指しており，これは呼び出しが行なわれるごとに上冉きされま 
す0 


ctime は UNIX システムで使用でき ， ANSI C と互換性があります。 

asctime , day light [变数）、 difftime ， ftime , getdate , gmtime ， 
localtime ， settime , time ， timezone (变数、 ， tzset 

asctime を参照してください 0 
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ctrlbrk 


機能 

形式 

プロトタイプ 

解脱 


戻り値 

可搬性 

閩連項目 


コントロールブレークハン ドラを セット します 0 
void ctrlbrk(int (* handler) (void )) : 


dos.h 


ctrlbrk は，が指す関数を，新たなコントロールブレークハンドラ 
としてセットします。割り込みベクタ 0x23 は，この関数を呼び出すように 
変更されます。 

ctrlbrk は，この関数を呼ひ•出す DOS の割り込みハンドラを作りあげま 
す。この関数が直接呼び出されることはありません。 

ハンドラ関数は，どんな操作やシステムコールを行なってもかまいません。 
ハンドラは，必らずしも元の位*に戻る必要はなく， longjmp を使ってプ 
ログラム内の任意の場所に戻ることができます。ハンドラ関数が0を返すと 
ブログラムは異常終了します。0以外の値を返した場合には，ブログラムの 
実行が再開されます。 

ctrlbrk は何も返しません。 

ctrlbrk は MS-DOS に特有の関数です。 

getcbrk , signal 


Turbo C « 率関数 リファレンス 


105 




/define ABORT 


int c_break(void 
{ 一 

printf("Contr 
return(ABORT) 


main() 

ctrlbrk(c 一 bre 
for (;;) { 
printf(*Lo 


ム出力 



delay 


名前 

形式 

ブロトタイプ 

機能脱明 

戻り値 
可撤性 

関連項目 


実行を一時停止させます。 

void delay , unsigned milliseconds )； 

dos.h 

delay を呼び出すと，現在実行中のブログラムは引数 milliseconds で指定し 
たミリ秒数だけ実行を一時停止します。正確な停止時間は，動作環境が異 
なると多少変化することがあります。 

ありません。 

この関数は PC .9801 (または IBM PC およびその互換機）でのみ動きま 
す。 

nosound , sleep , sound 
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difftime 


機能 

形式 

プロトタイプ 

解脱 

戻り偭 

可撤性 
M 連項目 
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2つの時刻の差を計算します。 

# include <time.h> 

double difftime (time t time2 ， time t time !) : 
time.h 

difftime は， tintel から time 2 ま での経過時間を秒単位で計算します。 
long 型のグローバル変数は， GMT とその地方の標準時の差を 
杪単位で保持しています （ PST — 太平洋镖準時の場合には 8 X 60 X 60) 。 グ 
ローバル変数 daylight ( i , 米国 K 時間の期間中にのみ〇以外の値をとるよ 
うになっています。 

difftime は計算の結果を double で返します。 

difftime は UNIX システムで使用でき ， ANSI C と互換性があります。 

asctime ， ctime , daylighH 宠如、 time , (栾数） 
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disable 


機能 

割り込みを不可にします。 

形式 

# include < dos . h > 


void disable ( void ) i 

プロトタイプ 

dos.h 

解脱 

disable は，ハードウ; l ア割り込みの制御が柔軟に行なえるように用意され 

ています。 

disable マクロは割り込みを不可にします。どんな外部デバイスからでも， 

NMI 割り込み (non-maskable interrupt) のみが許されることになりま 

す。 

戻り値 

戻り値はありません。 

可撤性 

disable マクロは 80 x 86 アーキテクチャに特有の関数です。 

関連項目 

enable , getvect 
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div 


機能 2 つの整数の除热を行なって，商と剰余を返します。 

形式 # include く stdlib.h〉 

div t div(int numer ,int denoni ) \ 

ブロトタイプ stdlib.h 

解脱 div は 2 つの整数の除算を行なって，商と剰余を divt 型として返します。 

賴 er と denom は， それぞれ非除数と除数です。 div t 型は整数の構造体 
で， stdlib.h の中で次のように typedef 宣言されています。 

typedef struct 
int quot; 
int rem ； 

)div_t; 

戻り偭 div は， W が（商） と rem (剰余）を要素に持つ構造体を返します。 

可搬性 div は ANSI C と互換性があります。 

関連項目 ldiv 

例 # include <8tdlib.h> 

div_t x; 

main() 

{ 

x ■ div(10 f 3); 

printf(*10 div 3 _ Zd remainder Zd¥n B f x.quot 9 x^rem); 

) 

ブログラム出力 
10 div 3-3 remainder 1 


/* 商 食 / 

/* 黐余*/ 
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dosexterr 


機能 DOS の拡張エラー情報を得ます。 

形式 # include < dos . h > 

int dosexterr (struct DOSERROR * eblkp ) \ 

プロトタイプ dos.h 

解脱 この関数は， DOS のシステムコールが不成功に終わった場合に，拡張エラ 

一情報を， A/ むが指す DOSERROR 構造体に埋め込みます。この構造体 
は次のように定義されています。 

struct DOSERROR 
int exterror 
char class; 
char action; 
char locus; 

) 

この怫造体の各値は， DOS のシステムコール 0 x 59 を通じて取得されます。 
ex / error の値が〇であれば，その前に行なわれた DOS コールはエラーにな 
らなかったことを意味します。 

戻り値 dosexterr は， DOSERROR 搆造体中の exterror の値を返します。 

可搬性 dosexterr は MS-DOS 3.0 に特有の関数で，それ以前のバージョンでは動 

作しません。 


/* 拡»エラー */ 
/* エラークラス */ 
/* 動作 */ 

/* エラーの 位置*/ 
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dostounix 


機能 

形式 

プロトタイプ 

解脱 

戻り偭 

可撤性 
N 連項目 
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日付と時刻を UNIX の時刻書式に変換します。 

# include < dos . h > 

long dostounix (struct date * め struct time * り： 


dos.h 

dostounix は， getdate と gettime で得た日付と時刻を UNIX の畨式に変 

換します。ゴは date 構造体を，/は time 構造体を指しており，2つの構造 

体はそれぞれ有効な DOS の日付およひ•時刻に関する悄報を含んでいると 
します。 

dostounix は UNIX 形式の現在時刻，つまり1970年1月1日午前〇時 ( GMT ) 
からの経過時間を秒数で表わしたものが返されます。 

dostounix は MS-DOS 特有の関数です。 

unixtodos 
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dup 


機能 

形式 

ブロトタイプ 

解脱 


戻り値 


可搬性 

M 連項目 


ファイルハンドルを複製します。 


int dup(int handle ) \ 


io.h 


dup は，元のファイルハンドルと次のような共通点を持つ新しいファイル 
ハンドルを返します0 

■同じオーブンファイルあるいはデバイス 

■同じファイルポインタ（つまり，一方のファイルポインタを変更する 
と，もう一方も変更されます） 

■同じアクセスモード（統み出し， If き込み，統み出し/#き込み） 

弓\数 handle H 、 creat , creat , open ， open , dup , dup 2 の呼び出しで 
得られたファイルハンドルです。 

成功した場合， dup は新しいファイルハンドル（負でない整数）を返し，ェ 
ラーの場合は-1を返します。 

エラーの場合， errm > は次のいずれかに セッ トされます。 

EMFILE オーブンファイルが多すぎる 

EBADF ファイル番号が正しくない 


dup はすべての UNIX システムで使用できます。 


close , close ， creat , creat , creatnew , creattemp , dup 2, 
fopen , open , open 
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dup2 


機能 ファイル ハン ドルを既存のファイル ハン ドルに複製します。 

形式 int dup 2 (int oldhandle , int newhandle ) : 

プロトタイプ io.h 

解脱 dup 2 は，元のファイル ハン ドルと次のような共通点を持つ新しいファイル 

ハンドルを作成します。 

■同じオーブンファイルあるいはデバイス 

■同じファイルポインタ（つまり，一方のファイルポインタを変更する 
と.もう一方も変更されます） 

■同じアクセスモード（読み出し，#き込み，読み出し/冉き込み） 

dup 2 は，パの値をもつ新しいファイ ルハン ドルを作成します。 
dup 2 が呼び出されたときに， newhandle に結びつけられたファイルがオー 
ブンされている場合は，そのファイルはクローズされます。 
newhandle と oldhandle li , creat , open , dup , dup 2 の呼び出しで得られ 

たファイル ハン ドルです。 

戻り価 dup 2 は成功した場合は0を返し，エラーの場合は-1を返します。 

エラーの場合， errno は次のいずれかにセットされます。 

EMFILE オーブンファイルが多すぎる 

EBADF ファイル番号が正しくない 

可搬性 dup 2 はいくつかの UNIX システムで使用できます。ただし， System III で 

は使用できません。 

閲連項目 close , close , creat , creat , creatnew , creattemp , dup ， 

fopen , open，open 
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ecvt 


機能 浮動小数点数を文字列に変換します。 

形式 char * ecvt (double value , int ndig , int * dec , int * sign ) : 

プロトタイプ stdlib.h 

解脱 ecvt は， va / we の値を，一番左の有効桁から始まりヌルで終わる ndig 桁の 

文字列に変換し，その文字列を指すポインタを返します。小数点が文字列 
の先頭から何桁目にあるかは，み c を通して間接的に格納されます（み c が 
ft の場合は，返された煅初の数字の左に小数点があることを意味します)。 
小数点は文字列そのものには含まれません。結果の符号が負のときは，抑/? 
が指すワードは0でなくなり，それ以外のときは0となります。下位の桁は 
四捨五入されます。 

戻り値 ecvt の戻り値は静的データを指しているので， ecvt が呼ばれるたびに，そ 

の内容は上害きされます。 

可搬性 ecvt は UNIX システムで使用できます。 

W 連項目 atof ， atoi ， atol , fcvt ， gcvt , printf 
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emit 


機能 リテラル値を直接コードに埋め込みます。 

構文 void emit ( argument , ...) : 


プロトタイプ dos.h 


脱明 _ _emit __はインライン関数であり，コンハ*イル時にオブジェクトコード 

の中に，リテラル値を直接埋め込むために使われます。これによって，イ 
ンラインアセンブリ言語やアセンブラを使わなくても，マシン語命令を生 
成することができます。インラインアセンブリが使えない統合開発環境の 
中でもこの関数を使用できます。 

一般的に， —_ emit _ の呼び出しでは 1 バイトマシンコード命令を指定しま 
すが，この関数では C の変数の参照などのより複雑な命令も使用できる機 
能をもっています。 

警告!この関数は， 80 x 86 プロセッサ ファ ミリの機械語によく通じているブ 
ログラマのみが使用すべきものです。この関数を使えば，関数の中に好き 
なバイトを埋め込むことができますが，もし間違いがあればブログラムは 
おかしな動作を示し，暴走してしまいます。 Turbo C は，この関数の呼び 
出しが正しいかどうかはまったくチェックしません。レジスタやメモリの 
内容を変更する命令を埋め込んだ場合， TurboC はそれを認識できず，イ 
ンラインアセンブリ言語において多くの場合になされるレジスタの保存も 
行なわれません（たとえば，インライン命令では， SI レジスタおよび DI レ 
ジスタが使われていることが認識されます）。この関数を使う場合はすべて 
ブログラマの責任となります。 

一一 emit 一には少なくとも1個は引数を渡す必要がありますが，それ以上で 
あればいくつ渡してもかまいません。これらの引数は，他の関数呼び出し 
における引数とは違う扱いを受けます。つまり，に渡される引数 
は変換されることはありません。 

一一 e mit _ _ への引数の形式に対しては特別な制限があります。静的なォブ 
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ジェクトを初期化するのに使用できる式の形式をとっていなければなりま 
せん。つまり，整数や浮動小数点の定数，静的なオブジヱクトのアドレス 
を使うことができます。こうした式の値は，オブジヱクトコード中の呼び 
出しの位置に，初期化データとして使用されるのとまったく同じように埋 
め込まれます。自動変数や引数変数のアドレス，これらに定数オフセット 
をブラスまたはマイナスしたものも使用することができます。これらの引 
数に対しては， BP からの変数のオフセットが格納されます。 

オブジヱクトコードの中で占めるバイト数は，次の場合を除いて，引数の 
型によって決まります。 

■その値が0から255の範囲の符号つき整定数（たとえば0 x 90〉は，文字 
と同様に扱われ，1バイトを占めます。 

■自動変数や引数変数のアドレスが使用される場合は， BP からの変数 
のオフセットが-128から127の範囲に入っていれば1バイト，それ以外 
は1ワードを占めます。 

1バイトは次のようにして苒くことができます。 

_ emit _ (0x90) ; 

値は255以下でもワードとして*きたい場合は，次のようにキャストを使う 
か， 

— emit _ (0xB8, (unsigned) 17 ) ; 

あるいは次のようにします。 

_ emit 一 （0xB8, 17u) ; 

2バイトあるいは4バイトのアドレスは，アドレスを void near 木あるいは 
void far * にキャストすることによって得られます。 

戻り値 ありません。 

可搬性 emit は，インテル 80 x 86 アーキテクチャに特有の関数です。 
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enable 


機能 

形式 

プロトタイプ 

解脱 

戻り値 
可搬性 

関連項目 
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割り込みを可能にします。 


# include < dos . h > 


void enable 、 void ) • 


dos.h 


enable は，ハードウエア割り込みの制御が柔軟に行なえるように用意され 
ています。 

enable マクロは，割り込みを可能にします。これによってどのデバイスか 
らでも削り込みができるようになります。 

戾り値はありません。 


enable は 80 x 86 アーキテクチャに特有の関数です。 


disable，eetvect 
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機能 


ファイルエン ドかどうかを調べます。 


形式 

プロトタイプ 

解脱 

戻り値 

M 連項目 


int eof(int handle ) : 

io.h 

eof は， handle に結びつけられたファイルがフアイルエンドに到達してい 
るかどうかを決定します。 

eof は，現在位56がファイルの終わりであれば1を返し，そうでなければ0を 
返します。戻り値が-1の場合はエラーを意味し， errm > に次の値がセット 
されます。 

EBADF ファイル番号が正しくない 

clearerr , feoi , ferror , perror 
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exec … 


機能 他のブログラムをロー ドして実行します。 

形式 int execKchar * path 、 char * argO , * argl ，…， * argn 、 NULL ) : 

int execle(char * path ， char * argO t * argl .* argn , NULL , 

char * * env ) : 

int execlp(char * path ， char * argO , * argl ，…， * argn ， NULL ) : 
int execlpe(char * path 、 char * argO , * argl f * argn , NULL , 

char * * env )； 

int execv(char * path 、 char 本 argv []) : 

int execve(char * path , char * argv [], char ** env ) : 

int execvp(char * path ， char * orgv[]) : 

int execvpe(char * path ， char * argv [], char ** env ) : 

プロトタイプ process.h 

解脱 exec …ファミリィの関数は，他のブログラムをロードし実行します。これ 

は“子ブロセス’’として知られています。 exec •••の呼出しが成功すると，子 
プロセスは“親ブロセス’’にオーバーレイします。子ブロセスをロー ドして 
実行するために充分なメモリ領域が存在しなければなりません。 
pa / A は，呼ひ•出される子ブロセスのファイル名です。 exec •••は， path を次 
のような MS-DOS 標準の手順で探します。 

■拡張子もピリオドもない場合は，まず与えられたファイル名を探しま 
す。存在しなければ .COM を付加して再び探します。それも存在しな 
ければ. EXE を付加してもう一度探します。 

■拡張子が与えられた場合は，与えられたとおりのファイル名を探しま 
す。 

■拡張子なしでピリオドがある場合は，拡張子なしでファイル名を探し 
ます。 


exec . ••につけられた接尾辞，1， v ， p ， e は，次のような意味をもっていま 
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P ファイル名を探す際に， DOS の環境変数 PATH にセットされて 

いるすべてのディレクトリを探索します （ p がついていない場合 
は，カレントディレクトリしか探索されません）。引数/^从には 
っきりとディレクトリが指定されていない場合には，敢初にカレ 
ントディレクトリを探し，次にルートディレクトリを探します。 

1 引数ポインタ ( argO t argl ， "” arg / j ) は，別々の引数として渡さ 

れることを意味します。一般に，引数の個数があらかじめわかっ 
ているときに接尾辞1がついたものが使われます。 

V 引数ポインタ <^v[0] . 狀 gv[/2]) は，ボインタの配列とし 

て渡されることを意味します。一般に，渡される引数の個数が可 
変のときに接尾辞 v がついたものが使われます。 
e 引数が子ブロセスに渡されることを意味します。これによ っ 
て子ブロセスの琛境を変えることができます。 e がつかない場合, 
子ブロセスは親ブロセスの環境を受けつぎます。 

exec …ファミリィの各関数は，引数に関する指定を行なう2つの接尾辞 （1 
または v ) のいずれかを含んでいなければなりません。パスのサーチ手順と 
環境の受けつぎ方に関する接尾辞 （ p と e ) はオプションで，なくてもかま 
いません。 

たとえば次のようになります。 


■ execl は，別々の引数を受け取り，ルートと現在の作業ディレクトリの 
みをサーチし，子ブロセスは親ブロセスの環境を受け継ぐ。 

■ execvpe は，引数ポインタの配列を受け取り， PATH で指定されたデ 
イレクトりをサーチし，子ブロセスの環境を変えるためにび v を受け 
取る。 


exec •••関数は，子プロセスへ渡す引数を少なくとも 1 個あるいは 
^• gv [ 0 ]) 持たなくてはなりません。この引数は惯習で普通は path のコビー 
です（別の値を使ってもエラーにはなりませんが)。 MS-DOS 3.ズでは，子 
プロセスで/?如//を使用することができますが，それより前の八ージョンで 
は〇番目の引数 、 argO または argv [0 ]) の渡された値を使うことはできませ 
ん〇 
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接尾辞 1 が使われている場合， a / •がは通常/^/；!を指し， arg /,..., ar がは新 
しい引数リストを形成する文字列を指します。 wg 乃の次の引数 NULL は 
必らず必要で，リストの終わりを示します。 

接尾辞 e が使われている場合，新しい環境変数のリストを引数か iv で渡す 
ことができます。⑼ v は char ポインタの配列で，各要素はヌルで終わる次 
のような文字列を指しています。 

enwar - value 

envvar は環境変数の名前であり， va/ue は enwar にセットされる文字列で 
す。⑼ v の最後の要素には NULL が入ります。 e / iv が NULL の場合，子ブ 
ロセスは親ブロセスの S 3 境設定を受けつぎます。 

arg0 + argl + … (あるいは argv[0] + argv[l] + 9 .. +argv|>]) の長 
さは，区切りの空白も含めて128バイトより短くなくてはなりません。ヌル 
文字はこれには含めません。 exec •••関数が呼び出されたとき，オーブンさ 
れているファイルはそのままになります。 

戻り値 成功した場合， exec •••関数は値を返しません。エラーの場合は-1を返し， 

errno には次のいずれかがセットされます。 

E 2 BIG 引数リストが長すぎる 

EACCES アクセス許可が否定されている 

EMFILE オーブンされているファイルが多すぎる 

ENOENT パス名あるいはファイル名が見つからない 

ENOEXEC exec 害式 エラー 

ENOMEM メモリが不足した 

可搬性 exec •••は MS - DOS 特有の関数です。 

間連項目 abort ， atexit , exit ， exit ， foreset , searchpath , 

spawn ..., system 
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exit 


機能 

形式 

プロトタイプ 

解脱 

戻り値 
可搬性 

関連項目 
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ブログラムを終了させます。 
void _exit(int status ) : 
process.h, stdlib.h 

一 exit は， フ アイルのクローズ，出力の フラッシュ， 終了時関数の呼び出し 
をいっさい行なわずにブロセスを終了させます。 

引数加は，ブロ セスの 終了 ステータスと して呼び出したブロ セスに 供 
給されます。一般的には，0は正常終了を示し，0以外の値はエラーを示す 
ために使われます。 

戻り値はありません。 

一 exit は UNIX システムで使用できます。 

abort , atexit , exec ..., exit , spawn ... 
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exit 


機能 

形式 

プロトタイプ 

解脱 


戻り値 
可撤性 
M 連項目 


プログラムを終了させます。 
void exit(int status ) : 
prosess . h , stdlib.h 

exit は，この関数を呼び出したブロセスを終了させます。終了する前に， 
すべてのオーブンされているファイルはクローズされ，バッファの中の出 
力（出力されるのを待っている）は#き出され，登録されている”終了時関 
数” （ atexit を参照）が呼び出されます。 

引数灯似⑽は，ブロセスの終了ステータスとして呼び出したブロセスに供 
給されます。一般的には，0は正常終了を示し，0以外の値はエラーを示す 
ために使われます。 


戻り値はありません。 


exit は UNIX システムで使用でき ， ANSI C と互換性があります。 

abort, atexit, exec..., exit, keep, signal, spawn... 
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機能 指数関数 e の a : 乗を返します0 

形式 # include < math . h > 

double exp (double x ). 

ブロトタイプ math.h 

解脱 exp は，指数関数を計典します 0 

戻り値 exp は， e x を返します。 

引数の値によっては，オーバーフローが起こったり，計算できないことが 
あります 0 オーバーフローが起きた場合， exp と pow は HUGE VAL を返 
します。大きさが非常に大きい結果は errno に次の値をセットします。 

ERANGE 結果が指定の範囲を越えた 

オーバーフローの場合には exp は〇.〇を返し， err / io は変更されません。 
exp のエラー処理は， matherr 関数を使って変史することができます。 

可撤性 exp は UNIX システムで使用でき， ANSI C と互換性があります。 

M 連項目 frexp , ldexp , log , loglO , matherr , pow , powlO , sqrt 
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fabs 


機能 

形式 

プロトタイプ 

解脱 

戻り値 
可撤性 
関連項目 


浮動小数点数の絶対値を返します。 

# include く math.h> 
double fabs (double x )； 


math.h 


fabs は， double 型の引数 x の絶対値を計算します 0 


fabs は， ズの 絶対値を返します。 エラーの 戻り値はありません。 
fabs は UNIX システムで使用でき ， ANSI C と互換性があります。 

abs , cabs , labs 
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farcalloc 


機能 ヒープからメモリを割り当てる 


形式 

プロトタイプ 


void far * farcalloc (unsigned long nunits , unsigned long unitsz ) \ 
alloc.c 


farcalloc は， far ヒープから各要素が wm /公バイトで，要素の数が” wm/j 
の配列用のメモリを割り当てます。 

far ヒープから割り当てに関しては，次の点に注意してください。 

■利用可能な RAM はすべて割リ当てることができる。 

■64 K バイトを超えるブロックを割り当てることができる。 

■割り当てられたブロックをアクセスするには far ポインタが使用され 
る。 


コンパクト，フージ，ヒユージメモリモデルでは， farcalloc は， calloc と 
まったく同じではありませんがよく似ています。 farcalloc は unsigned 
long の引数をとるのに対し， calloc は unsigned の引数をとります 
タイニィモデルでは，ブログラムを .COM ファイルに変換する場合には， 
farcalloc を使うことはできません。 

戻り値 farcalloc は，新たに割り当てられたブロックを指すポインタを返します 

要求した大きさのメモリ領域を割り当てることができなかった場合には 
NULL を返します。 

可搬性 farcalloc は MS-DOS に特有の関数です。 

関連項目 calloc , farcoreleft , farfree , malloc 
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farcoreleft 


機能 

形式 

ブロトタイプ 

解脱 

戻り価 

可搬性 
間連項目 

例 


far ヒープの未使用メモリの量を返します。 
unsigned long rarcoreleft (voia) i 
alloc.h 

farcoreleft は， far ヒープ中の割り当て済みの煅高位ブロックの上にある 
未使用メモリの M を返します。 

タイニイモデルでは，ブログラムを. COM ファイルに変換する場合には, 
farcoreleft を使うことはできません。 


farcoreleft は，割リ当て済みの敢商位ブロックとメモリの終わりの問の未 
使用領域の链を返します。 


farcoreleft は MS - DOS に特有のものです。 


coreleft ， larcalloc , farmalloc 


farmalloc を参照してください 0 
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farfree 
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far ヒーブからブロックを1個解放します〇 


void farfree (void far * block ) : 


alloc.h 

farfree は，以前に far ヒープに割り当てられたメモリブロックを解放し 
ます。 

タイニィモデルでは，ブログラムを . COM ファイルに変換する場合には, 
farfree を使うことはできません。 

スモールおよひ•ミディアムモデルでは， farmalloc で割り当てられたブロ 
ックは，通常の free では解放されません。また malloc で割り当てられた 
ブロックは， farfree では解放できません。これらのモデルでは，2つのヒ 
ーブはまったく別物ということになります。 

戻り値はありません。 

farfree は MS - DOS に特有の関数です。 

farcalloc . farmalloc 


farmalloc を参照してください 0 
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farmalloc 


機能 

形式 

プロトタイプ 

解脱 


戻り値 

可搬性 

閭連項目 


far ヒープにメモリを割り当てます。 

void far 木 farmalloc (unsigned long nbytes) 


alloc.h 


farmalloc は， far ヒープから声 j バイトの長さのメモリブロックを割 
り当てます。 

far ヒープからの割り当てに関しては，次の点に注意してください。 

■利用可能な RAM はすべて割り当てることができる。 

■64 K バイトを超えるブロックを割り当てることができる。 

■割り当てられたブロックをアクセスするには far ポインタが使用され 
る。 


コンパクト，ラージ，ヒュージメモリモデルでは， farmalloc は ， malloc 
とまったく同じではありませんがよく似ています。 farmalloc は unsigned 
long の引数をとるのに対し， malloc は unsigned の引数をとります 0 
. タイニイモデルでは，ブログラムを . COM ファイルに変換する場合には， 
farmalloc を使うことはできません。 


farmalloc は，新たに割り当てられたブロックを指すポインタを返します。 
要求した大きさのメモリ領域を割り当てることができなかった場合には 
NULL を返します。 


farmalloc は MS - DOS に特有の関数です。 


farcalloc , larcoreleft ， farfree , farrealloc , malloc 
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/* その一部を得る */ 
block _ fannalloc(size) : 
if (block — NULL) 







farrealloc 


機能 

形式 

ブロトタイプ 

解脱 


戻り値 

可搬性 

関連項目 


far ヒープに割り当て済みのブロックを調整します。 


void iar 氺 farrealloc (void far * old block , unsigned long n bytes ) : 


alloc.h 


farealloc は，割り当てられているブロックの大きさを nbytes に変更しま 

す0必要ならば内容のコビーも行ないます。 

far ヒープから割り当てに関しては，次の点に注意してください。 

■利用可能な RAM はすべて割り当てることができる。 

■64 K バイトを超えるブロックを割り当てることができる。 

■割り当てられたブロックをアクセスするには far ボインタを使用する。 

タイニィモデルでは，ブログラムを. COM ファイルに変換する場合には， 
farrealloc を使うことはできません 0 

farrealloc は，再割り当てされたブロックのアドレスを返します。これは 
もとのブロックのアドレスとは異なることもあります。ブロックを再割り 
当てできなかった場合， farrealloc は NULL を返します。 

farrealloc は， MS-DOS に特有の関数です。 

farmalloc , realloc 
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fclose 


機能 

形式 

プロトタイプ 

解脱 

戻り値 
可搬性 
閲連項目 

例 
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ストリームをクローズします。 


# include く stdio.h 〉 

int fclose (FILE * stream ) : 

stdio.h 

fclose は，引数が ream に指定されたストリームをクローズします。一般 
に，ストリームに結ひ•つけられているすべてのバッファの内容は，クロー 
ズの前にフラッシュされます。システムが割り当てたバッファはクローズ 
によって解放されます 0 setbuf あるいは setvbuf で割り当てられたバッフ 
ァは自動的には解放されません。 

fclose は，成功した場合0を返します。 

fclose は UNIX システムで使用でき ， ANSI C と互換性があります。 

close , fclosealK fdopen ， fflush ， flushall,freopen 
fopen を参照してください。 
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fcloseall 


機能 

形式 

プロトタイプ 

解脱 

戻り値 

可搬性 
閣連項目 


オーブンされているストリームをクローズします。 
int iclosealhvoid ) ； 


stdio.h 


fcloseall は， stdin % stdout , stdprn % stderr , およびがぬ w ズを除くすべての 
オーブンストリームをクローズします。 

fcloseall は，クローズしたストリームの数を返します。エラーがあった場 
合は EOF を返します。 

fcloseall は UNIX システムで使用できます。 

fclose ， faopen , flushalh fooen , ireopen 
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fcvt 
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浮動小数点数を文字列に変換します。 


# include く stdlib 〉 

char * fcvt (double value , int w ゴ反 ， int 本 aec , int * sign )； 


stdio.h 


fcvt は， value の値を，一番左の有効桁から始まりヌルで終わる ndig 桁の 
文字列に変換し，その文字列を指すポインタを返します。小数点が文字列 
の先頭から何桁目にあるかは，办 c を通して間接的に格納されます（ふ c が 
ft の場合は，返された®:初の数字の左に小数点があることを意味します〉。 
小数点は文字列そのものには含まれません。結果の符号が負の ときは 、 sign 
が指すワードは0でなくなり，それ以外のときは0となります。 

数値は， ndig に指定された桁数までに四捨五入されます。 

fcvt の炅り値は静的データを指しているので， fcvt が呼ばれるたびに，そ 
の内容は上冉きされます。 


fcvt は UNIX システムで使用できます。 


atol ， atoi ， atol , ecvt , gcvt 
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fdopen 


機能 ストリームとファイル ハン ドルを結びつけます 0 

形式 # include く stdio . h 〉 

FILE * fdopen (int handle , char * type ) \ 

プロトタイプ stdio.h 


解脱 fdopen は， creat ， dup ， dup 2， open などによって得られたファイルハン 

ドルとストリームを結びつけます。ストリームのタイプは，オーブンされ 
ている handle のモー ドと一致しなければなりません。 
fdopen で使用される文字列 type は， 次の値のいずれかです。 

r 読み出し雄用としてオーブンする。 

w 神き込み用として作成する。 

a 追加用。ファイルの終わりに#き込むようにオーブンする。 

ファイルが存在しない場合は冉き込み用として作成する。 

/*+ 既存ファイルを更新（読み出し/弃き込み）用として作成す 

る。 

新規ファイルを更新用として作成する。 
a + 追加用としてオーブンする0ファイルの終わりから更新用と 

してオーブンする（ファイルが存在しなければ作成する ） 〇 


ファイルがテキストモードでオーブンあるいは作成されることを指定する 
には，077 e の値の最後に r をつけます（"， w + f など)。同様に，バイナリ 
モードを指定するには，び/把の値の最後に ft をつけます（心 ， a 七 b な 

ど)。 

t または6が〇7ぞに指定されていない場合は， モー ドはグローバル変数 
fmorfe によって決まります。が 0 BINARY にセットされてい 
れば，フアイルはバイナリモードでオーブンされます。 fmode が0 
TEXT がセットされていれば，テキストモードでオーブンされます。定数 
〇…は， fcntl . h で定義されています。 
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戻り値 

可搬性 
閩連項目 

例 
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ファイルが更新用にオーブンされていると，そのストリームに対して入力 
と出力が行なえなす。しかし，出力のあとで， fseek あるいは rewind を行 
なうことなしに入力を行なうことはできません。また入力のあとで， 
fseek , rewind , ファイルの終わりを検出する入力のいずれかを行なうこと 
なしに出力を行なうこともできません。 

成功した場合， fdopen は新たにオーブンされたストリームを返します。エ 
ラーの場合は NULL を返します。 


fdooen は UNIX システムで使用できます。 


fclose ， fopen , ireopen , open 


#include <8tdio.h> 

#include <fcntl.h> /* open が使用するモードの定義が必羅 */ 

main() 

{ 

int handle ； 

PILE *8tream; 

/* フアイルをオープン */ 

handle ■ open(•MYFILE.TXT• t 0_CREAT); 

/* ストリームに艚びつける */ 
stream _ fdopen(handle 9 )； 
if (stream __ HULL) 

printfCfdopen failed¥n *)； 
else 
{ 

fprintf(stream, •Hello, world¥n*); 
fclo8e(stream); 
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feof 


機能 

形式 

プロトタイプ 

解脱 

戻り値 

可搬性 

関連項目 


ストリーム上でファイルエンドを検出します。 


# include く stdio . h 〉 

int feof (FILE * stream) \ 

stdio.h 

feof は，指定した J ヶ earn に対して，ファイル終了標識を調べるマクロで 
す 0 標識が一度セットされると， rewind が呼び出されるか，そのファイル 
がクローズされるまで，そのファイルに対する統み出し揀作はファイル終 
了標識を返します。 

ファイル終了標識は各入力操作でリセットされます。 

feof は，指定のストリームに対する®:後の人力操作で，ファイル終了標識 
が検出された場合に，0でない値を返します。 

feof は UNIX システムで使用でき， ANSI C と互換性があります。 

clearerr , eoi , ferror , perror 
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ferror 


機能 

形式 

プロトタイプ 

解脱 

戻り価 

可撤性 

関連項目 
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ストリーム上のエラーを検出します。 

# include 〈 stdio . h 〉 

int ferror (FILE * stream ) : 


stdio.h 

ferror は，指定した stream に対して，読み出しおよび冉き込みエラーがな 
いかどうかを調べるマクロです。 stream にエラー標識が一度セットされる 
と， clearerr または rewind が呼ひ•出されるまで，あるいはそのストリーム 
がクローズされるまで，エラー標識は セッ トされたままになります。 

ferror は，指定のストリーム上でエラーを検出すると0でない値を返しま 
す。 

ferror は UNIX システムで使用でき ， ANSI C と互換性があります 0 

clearerr , eof , feof , iopen , gets , perror 
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fflush 


機能 

形式 

ブロトタイプ 

解脱 

戻り値 

可撤性 

関連項目 


ストリームをフラッシュします。 

# include く stdio . h 〉 
int fflush (FILE + stream ) : 

stdio.h 

fflush は，指定されたストリームが出力用にオーブンされている場合に 
は， stream のための バッファ 中の出力を結びつけられている ファ イルに宵 
き出します。 

stream が入力用にオーブンされている場合には， バッファの 内容がクリア 
されます。 

ストリームは， fflush を実行した後もオーブンされたままです。 fflush は 
バッファ リングされないストリームには何の影®も与えません。 

fflush は，成功した場合0を返します。エラーが検出された場合は EOF を 
返します。 

fflush は UNIX システムで使用でき ， ANSI C と互換性があります。 

fclose，flushall setbuf，setvbuf 
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ストリームから文字を得ます。 


# include く stdio . h 〉 
int fgetc(FILE * stream ) \ 

stdio.h 

fgetc は，指定されたストリーム上の次の文字を返します。 

成功した場合， fgetc は統み込んだ文字を符号拡張せずに int に g 
返します。ファイルエンドまたはエラーの場合は EOF を返します 


fgetc は UNIX システムで使用でき， ANSI C と互換性がありま1 



fgetchar 


機能 stdin から文字を得ます。 

形式 int fgetchar (void) : 

プロトタイプ stdio.h 

解脱 fgetchar は， J / 心から次の1文字を読み込んで返します。 

fgetchar は， fgetc ( stdin ) と定義されたマクロです。 

戻り価 成功した場合， fgetchar は読み込んだ文字を符号拡張せずに int に変換し 

て返します。ファイルエンドまたはエラーの場合は EOF を返します。 
EOF は fgetchar が通常の値として返すものなので，ファイルエンドやエ 
ラーを検出するためには， feof あるいは ferror を使う必要があります 0 

可搬性 fgetchar は UNIX システムで使用できます。 

関連項目 fgetc ， fputchar，getchar 
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fgetpos 

機能 現在のファイルポインタを得ます。 

形式 # include く stdio . h 〉 

int fgetpos (FILE + stream , fpos t * pos ) : 

プロトタイプ stdio.h 

解脱 fgetpos は， srr 的 m ? に結びつけられているファイルポインタの位置を， 

が指している場所に格納します。 

fPO ^ J 型は stdio . h の中で， long 型として typedef 宣言されています。 

戻り値 fgetpos は成功した場合は0を返し，失敗した場合は0以外の値を返します。 

M 連項目 fseek , fsetpos , ftell，tell 
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fgets 


機能 ストリームから文字列を得る 

形式 # include く stdio . h 〉 

char * fgets (char * s t int n t FILE * stream ) : 

プロトタイプ stdio.h 

解脱 fgets は， stream から文字の並ひ•を1充み，文字列 J に格納します。読み込み 

は， （ W — 1) 個の文字を読み込むか，改行文字を読み込んだ段階で終わりま 
す。 fgets は，改行文字は文字列に含めません。 J に読み込まれた®後の文 
字の後にはヌル文字がつきます。 

戻り値 fgets は J が指している文字列を返します。ファイルエンドあるいはエラ 

一の場合は NULL を返します。 

可搬性 fgets は UNIX システムで使用でき， ANSIC と互換性があります。 K&R 

でも定我されています。 

関連項目 cgets , fputs , gets 
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filelength 


機能 

形式 

プロトタイプ 

解脱 

戻り値 

M 連項目 
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ファイルの長さをバイト単位で得ます。 


# include < io . h > 

long filelength Unt handle ) : 

io.h 


filelength は，に結びつけられているファイルの長さをバイト単位 
で返します。 


成功した場合， fUelength はファイルの長さを long 型で返します。エラー 
の場合は-1を返し， err / io に次の値をセットします。 

EBADF ファイル番号が正しくない 

fopen , lseek，open 
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fileno 


機能 ファイルハンドルを得る 

形式 # include < stdio . h > 

int fileno (FILE * stream ) \ 

プロトタイプ stdio.h 

解脱 fileno は，引数 s / reaw のファイル ハン ドルを返すマクロです。が reom が複 

数のハンドルを持つ場合， fileno はそのストリームが缎初にオーブンされ 
たときに割り当てられたハンドルを返します。 

戻り値 stream に 結びつけられたファイルハンドルを表わす挤数値を返します。 

可撤性 fileno は UNIX システムで使用できます。 

間連項目 fdopen ， fopen , freopen 
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findfirst 


機能 ディスクディレクトリを探索する。 

形式 # include < dir . h > 

# include < dos . h > 

int findfirst (const char * pathname , struct ffblk * ffblk , int attrib ) \ 
プロトタイプ dir.h 

解脱 findfirst は， DOS のシステムコール 0 x 4 E を使って，ディスクデイレクト 

リの探索を開始します0 

pathname は， 探索するファイル名の前にオブシヨンのドライブ名，パス名 
がついたものです。ファイル名の部分には，ワイルドカード （?，*) を含 
めることができます。一致するファイルが見つかった垛合は， ffblk 構造体 
にはファイルディレクトリ悄報がしまわれます。 
ffblk 構造体は次のように定我されています。 

struct ffblk { 

char ff_re8erved[21] 
char ff_attrib; 
int ff_ftime; 
int ff_fdate; 
long ff_fsize; 
char ff_name[13 ]5 

am 必は MS-DOS のファイル属性バイトであり，探索に際して，選択の基 
準となるものです。 attrib は dos . h の中で定義されている次の定数のいず 
れかとなります。 

FARDONLY 読み出し専用 

FAHIDDEN 不可視ファイル 

FASYSTEM システムファイル 

FA_LABEL ボリュームラべル 

FA_DIREC ディレクトリ 

FA ARCH アーカイブ 


/* MS-DOS で予約*/ 
/* ァトリビュート*/ 
/* ファイルの！ •« */ 
/* ファイルの日付*/ 
/* ファイルサイズ*/ 
/* ファイル名 */ 
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これらの属性についての詳細は， MS - DOS ブログラマーズリファレンスマ 
ニュアルを参照してください〇 

findfirst は， DOS のディスクトランスファアドレス （ DTA ) に， ffblk の 
アドレスをセットすることに注意してください。 

DTA の値を必要とする場合は， findfirst の各呼び出しの後で， （ getdta と 
setdta を使って） DTA をセーブして元に戻す必要があります。 

戻り値 pathname に一致するファイルが見つかった場合， findfirst は0を返しま 

す。一致するファイルが見つからない場合や，ファイル名に誤りがある場 
合は-1を返し， errno に次のいずれかの値をセットします。 

ENOENT パス名やファイル名が見つからない 

ENMFILE もうファイルがない 

可搬性 findfirst は MS - DOS に特有のものです。 

関連項目 findnext 

例 # include <8tdio.h> 

linclude <dir.h> 


main() 

{ 

struct ffblk ffblk; 
int done； 

printf(•Directory listing of *•*¥!!•>; 
done - findfirst (響 *.* •• &ffblk. 0 ); 
while (Idone) 

{ 

printf(_ Z8¥n" f ffblk.ff_name); 

done _ findnext((ffblk); 


プログラム出力 


Directory listing of *•* 
PINDFRST.C 
FINDFRST^OBJ 
FINDFRST.MAP 
PINDFRST.EXE 
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findnext 


機能 

形式 

プロトタイプ 

解脱 


戻り値 


可搬性 

関連項目 

例 
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findfirst での探索を続けます。 


# include <dir.h> 

int findnext (struct ffblk * fjblk) \ 
dir.h 

findnext は， findfirst で指定した pathname に一致する次のファイルを 
探すために使用します。讲/んは， findfirst の呼び出しで情報が格納された 
ブロックと同じものです。このブロックには，探索を統けるために必要な 
情報が含まれています 。 findnext li , pathname に一致するファイルが対象 
のデイレクトリの中で見つからなくなるまで，1[口 J の呼び出しごとに1つず 
つファイル名を返します 0 

findnext は， MS - DOS のデイスクトランスファアドレス （ DTA ) に ， ffblk 
のアドレスをセットすることに注意してください。 

DTA の値を必要とする場合は， findnext の各呼び出しの後で， （ getdta と 
setdta を使って） DTA をセーブして元に戻す必要があります。 

pathname に一致するファイルが見つかった場合， findnext は0を返しま 
す。もう一致するファイルが見つからない場合や，ファイル名に誤りがあ 
る場合は-1を返し， errno に次のいずれかの値をセットします。 

ENOENT パス名やファイル名が見つからない 

ENMFILE もうフアイルがない 


findnext は MS - DOS に特有の関数です。 


findfirst 


findfirst を参照してください。 


第 2章 Turbo C ライブラリ 


floor 


機能 

形式 

プロトタイプ 

解脱 
戻り値 
可搬性 
閫連項目 


小数点以下の切り捨てを行ないます。 


# include <math.h> 
double floor (double x ) : 


math.h 


floor は，ズを越えない敢大の整数を返します 0 

floor は，見つかった整数を double で返します。 

floor は UNIX システムで使用でき ， ANSI C と互換性があります。 

ceil fmod 
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flushall 


機能 

形式 

プロトタイト 

解脱 

戻り値 

可搬性 

間連項目 
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すべてのバッファをフラッシュします。 
int flushall (void ) ； 

stdio.h 

flushall は，オーブンされている入カストリームに結合しているすべての 
バッファのすべてをクリアし，出カストリームに結びつけられているすべ 
てのバッファの内容を対応するファイルに再き出します。 flushall の後で 
统み込みを行なうと，入カファイルからバッファにデータを新たに読み込 
むことになります。 

flushall の実行後も，ストリームはオーブンされたままです。 

flushall は，オーブンされている入力および出カストリームの数を返しま 
す。エラーがあった場合は EOF を返します。 


flushall は UNIX システムで使用できます。 


fclose , fcloseall , fflush 
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fmod 


機能 ズを夕で割った剰余を計弈します。 

形式 # include く math . h 〉 

double fmod (double ズ ， double y ) \ 

プロトタイプ math.h 

解脱 fmod は，ズを少で割った余り（ズ= />+/および0 = く/く少を満たす/。/•は 

整数）を計 W します。 

戻り値 fmod は，剌余/ (x = iy -f /) を返します。 

可撤性 fmod は ANSI C と互換性があります。 

間連項目 ciel ， floor , modf 
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fnmerge 

機能 ファイル名を作ります。 

形式 # include < dir . h > 

void fnmerge (char 本 path , const char 氺 drive , const cnar * dir , 

const char * name ， const char * ext ) : 

プロトタイプ dir.h 

解脱 fnmerge は，要素を組み合わせてパス名を作り出します。新しいハ•ス名は 

次の形式になります。 

X : ¥ DIR ¥ SUBDIR ¥ N AME.EXT 

この ファ イル名は次のようにして構成されます。 

■父は， rfr / ve によって与えられる 

■ ¥ DIR ¥ SUBDIR は， rf/r によって与えられる 

■ NAME.EXT は， rnzme とぞズ/によって与えられる 

fnmerge は， path には 檐 成されたパス名を格納するのに充分な領域があ 
るものとみなします。 檐 成されるパス名の®大長は MAXPATH です。 
MAXPATH は dir.h で定義されています。 

fnmerge と fnsplit は，ちょうど逆の操作を行ないます。つまり，あるパス 
名を fnsplit で分解して， fnmerge で各要素からバス名を組み立てると，元 
のパスが復元されます。 

戻り 値 ありません。 

可搬性 fnmerge は MS-DOS でのみ使用できます。 

関連項目 fnsplit 
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例 


/include <stdio.h> 
/include <dir.h> 


char drive(MAXDRIVE); 
char dir(MAXDIR); 
char file(MAVFILE); 
char ext(MAXEXT]; 

main() 

{ 

char s[MAXPATH) t t(MAXPATH]; 
int flag ； 

for (: ;) 

( 

printfC > •)； /* さらに入力があるかぎり*/ 

if (lgets(3)) break; /* 入力のプロンプトを表示*/ 
if (Igetsf 0 ]) break; 
flag _ fnsplit(8 f drive # dir f file t ext); 

/* 矍索を表示*/ 

printf(• drive ： Zs f dir: Zs f file: Xe. ext* Zs t ■• 
drive f dir f file 9 ext); 
printf( a flags x •); 
if (flag & DRIVE) 
printfC ：•); 
if (flag & DIRECTORY) 
printf(); 
if (flag & FILENAME) 

printfCf ); 

if (flag & BXTEHTION) 
printf (' e *) 5 
printf("¥n*); 

/* 各*索を再構成して元の文字列と比較*/ 
fnmerge(t•drive,dir•file ， ext >; 

if (strcmp(t.8) I- 0 ) I* 起こるはずはない*/ 

printf(• ― > strings are different!■); 


ブログラム出力 

> C:¥TURB0C¥FN-C 

drives Cs f dir: ¥TURB0C¥, files FN f ext: .C t 
flags: : dfe 

> PILE-C 

drive: t dir: , files FILE, ext: X, flags; fe 

> ¥TURB0C¥SUBDIR|HOEXT• 

drives f dirs ¥TURBOC¥SUBDIR¥ f file: N0EXT f 
ext: flags : dfe 

> CxMYPILE 

drive: C:, dir: , file : MYFILE f exts , flags : f 
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fnsplit 

機能 フルパス名を要素に分割します。 

形式 # include < dir . h > 

int fnsplit (const char * path 、char 本 drive , char 本 dir , 

char 本 name , char * ext ) : 

プロトタイプ dir.h 

解脱 fnsplit は，次の形式の文字列が表わすファイルのフルハ•ス名 ( path ) を， 

4つの要素に分割します。 

X : ¥ DIR ¥ SUBDIR ¥ N AME.EXT 

各要紊はそれぞれゴ r / Ve ， め r ， name , どズ/が指す文字列に格納されます （5 
つの引数すべてを渡さなければなりません。要素には NULL を指定する 
ことができますが，その場合，その要素の解析が行なわれるだけでどこに 
も格納されません）。 

これら文字列の最大長は，定数 MAXDRIVE ， MAXDIR , MAXPATH , 
MAXNAM ( dir . h の中で定義されています）で与えられます。これらの中 
にはヌル文字のスペースも含まれます。 


定数 

(最大長） 

文字列 

MAXPATH 

(80) 

path 

MAXDRIVE 

(3) 

drive ••コロン （ ： ） も含む 

MAXDIR 

(66) 

ル：先頭と最後の円記号 （¥) も含む 

MAXFILE 

(9) 

name 

MAXNET 

(5) 

ext :先頭のピリオド （•） も含む 
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fnsplit は， NULL でない要素を格納するための充分な大きさのスペース 
があることを仮定しています。 

fnsplit が path を分割するときには，次の規則が適用されます。 


■めかどには，コロンが含まれる （ C :, A : など） 

疆 dir には， 先頭と最後の円記号も含まれる （¥ turbo ¥ include , 
¥ source ¥ など） 

■ / rnrne には，ファイル名が含まれる 
Mext 拡張子の前のピリオドが含まれる 


fnsplit と fnmerge はちょうど逆の操作を行ないます。ある path を 
fnsplit で分割して，分割した各要素を fnmerge で組み立てると，元の 
path ができ h が^) ます。 

戻り値 fnsplit は，フルバス名のどの要素が path の中に含まれているかを表わす 

( dir . h で定義されている5個のフラグからなる）！5?数を返します。各フラグ 
と対応する要素は次のようになっています。 


EXTENSION 

FILENAME 

DIRECTORY 

DRIVE 

WILDCARD 


拡張子 
ファイル名 

ディレクトリ（およびサブディレクトリ） 
ドライブ指定 （ dir . h を参照） 

ワイルドカード （* または?） 


可搬性 fnsplit は MS-DOS システムでのみ使用可能です。 

関連項目 fnmerge 

例 fnmerge を参照してください。 
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fopen 

機能 ストリームをオーブンする。 

形式 # include <stdio.h> 

FILE * fopen iconst cnar + filename , const char * mode )； 

プロトタイプ stdio.h 

解脱 fopen は/?で指定されたファイルをオーブンし，ストリームと結び 

つけます。 fopen は以後の操作でそのストリームを識別するのに使用され 
るポインタを返します。 

fopen で使用される文字列 mode li , 次の値のいずれかです。 

r 說み出し诤用としてオーブンする。 

^ 苒き込み用として作成する。 

a 追加用。ファイルの終わりに搿き込むようにオーブンする。 

ファイルが存在しない場合は#き込み用として作成する。 
既存ファイルを更新（ I 充み出し/冉き込み）用として作成す 
る。 

新規ファイルを更新用として作成する。 

追加用としてオーブンする 0 ファイルの終わりから更新用と 
してオーブンする（ファイルが存在しなければ作成する）。 

ファイルがテキストモードでオーブンあるいは作成されることを指定する 
には， mode の値の最後に f をつけます （ rt , w + f など)。同様に， パイ十 
リモードを指定するには， mo ゴ e の値の最後に6をつけます （ vv 6, fl + ft な 
ど)。 fopen では，文字 r または 6 を， mo * 文字列中の文字と十の間に入 
れてもかまいません。たとえば，"十は r + f と同じ意味をもちます。 

1 または * が wo みに指定されていない場合は，モードは グロー ハ V レ 変数 
によって決まります。 /> norfe が0 BINARY にセットされてい 
れば，ファイルはバイナリモードでオーブンされます。 — に 
0— TEXT がセットされていれば，テキストモードでオープンされます。定 
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戻り値 

可撤性 

関連項目 

例 


数 0... は， fcntl.h で定義されます。 

ファイルが 更新用にオーブンされていると， その ストリームに対して入力 
と 出力が 行なえな す。 しかし， 出力の あとで， fseek あるいは rewind を 行 
なうことなしに 入力を 行なうことはできません。また 入力の あとで， 
fseek , rewind , ファイルの 終わり を検出す る 入力の いずれ かを 行なうこと 
なしに 出力を 行なうこともできません。 

成功した場合， fopen は新たにオーブンされたストリームへのボインタを 
返します。 エラーの 場合は NULL を返します。 

fopen は UNIX システムで使用でき ， ANSI C と互換性があります〇 K & 
R でも定義されています。 

creat ， dup , fclose , fdopen ， ferror ， /Vnorfe (変数）， fopen ， 
fread ， freopen ， fseek ， fwrite ， open , rewind ， setbuf , setmode 


I* AUTOEXEC.BAT ファイルのバックアップを作成するプログラム */ 

# include <8tdio.h> 

main() 

{ 

FILE *in f *out; 

if ((in _ fopenCWAUTOEXEC.BAT' *rf)) ― HULL) 

{ 

fprint(stderr f •Cannot open input file.¥n*); 
return (1); 

> 

if ((out _ fopenC¥¥AUTOEXBC.BAK* t -wt*)) ― HULL) 

< 

fprint(stderr t •Cannot open output file.¥n*); 
return (1); 

) 

while ( 1 feof(in)) 

fputc(fgetc(in>, out); 
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FP OFF 


機能 

形式 

プロトタイプ 

解脱 

戻り価 
間連項目 

例 
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far アドレスのオフセット値を得ます。 

# include <dos.h> 

unsigned FP OFF (farpointer ) : 


dos.h 

FPOFF マクロは， far ポインタル//於/•のオフ セツ ト値を得るために 
使用されます。 

FP 一 OFF は，オフセツト値を表わす符号なし整数値を返します。 

FP _ SEG , MK FP , vnovedata , spread 

#include <8tdio.h> 

#include <dos.h> 

main () 

{ 

char far *ptr; 
unsigned seg, off； 

ptr - MK PP(0xB000 f 0)； 
seg - PP_SEG(ptr); 
off - FP_0FF(ptr); 

)printf(-far ptr ZFp, segment 204x offset 204x¥n B ,ptr.seg.off)； 
ブログラム出力 


far ptr B000: 000 0, segment b000 f offset 0000 
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fpreset 


機能 浮動小数点数学ハ•ッケージを再初期化します。 

形式 void fpreset ( void ) : 


プロトタイブ float.h 


解脱 — fpreset は，浮動小数点数学パッケージの再初期化を行ないます。この関 

数は通常， system , exec ..., spawn •••関数とともに使用されます 0 

注意： MS - DOS のバージヨン2.ズや3.ズより前のバージヨンの下で，ブロ 
グラム中で8087/80287コプロセッサが使用されている場合， ( system , 
exec …， spawn ••.関数で実行した）子ブロセスは，親ブロセスの浮動小数点 
状態を変更する場合があります。 

8087/80287を使う場合は次のような点に注意してください。 

■浮動小数点の式を評価している間は, system , exec ..., spawn •••関数 
は呼び出さない。 

■子ブロセスが8087/80287で浮動小数点操作を行なつた可能性がある場 
合は， system , exec ..., spawn •••関数の後てし fpreset を呼んで，浮動 
小数点状態をリセットすべきである。 

戻り値 戻り値はありません。 

関連項目 clear 87, control 87, exec ..., spawn ..., status 87 ，system 
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fprintf 


機能 

形式 

プロトタイプ 

解脱 

戻り値 

可搬性 

関連項目 

例 
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ストリームに#式つき出力を行ないます。 

# include く stidio . h 〉 

int ipnntf(FIL 匕* stream ，const char * jormat [, argument ,...]); 
stdio.h 

fprintf は， / or / rnn によって指される#式文字列中の書式指定を ， format 
の後に統く各引数に適用し，害式化されたデータを指定されたストリーム 
に出力します。港式指定の数は，後に絞く引数と同じだけなければなりま 
せん。 

件式指定に関する詳細な情報については， printf の解説を参照してくださ 


fprintf は，出力したバイト数を返します。エラーの場合には EOF を返し 
ます。 

fprintf は UNIX システムで使用でき， ANSIC と互換性があります。 K & 
R でも定義されています。 

cprmti , fscanf , printf , putc，sprintf 

printf を参照してください。 
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FP SEG 


機能 

形式 

プロトタイプ 

解脱 

戻り価 
関連項目 

例 


far アドレスのセグメント f 直を i 导ます。 


# include <dos.h> 

unsigned FF SEG ifarpointer ) \ 


dos.h 


FP SEG マクロは ， far ボイ 、ノタ farpointer のセブメン ト値を得るために 
使用されます。 


FP_SEG は，セグメント値を表わす符号なし格数値を返します。 

FP OFF，MK FP 

FP OFF を参照してください。 
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fputc 


ストリームへ 1 文字を出力します。 


機能 

形式 

プロトタイプ 

解脱 

戻り価 

可搬性 

関連項目 
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# include <stdio.h> 

int iputc(int c ，FILE * stream ) : 


stdio.h 


fputc は，文字 c を指定したストリーム於 ream へ出力します。 

成功した場合， fputc は文字 c を返します。エラーの場合は EOF を返しま 
す0 


fputc は UNIX システムで使用でき ， ANSI C と互換性があります。 

fgetc , putc 
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fputchar 


檐能 

stdout へ 1 文字出力します 0 

形式 

# include く stdio . h 〉 


int iputchar(int c ) : 


ブロトタイプ stdio.h 

解脱 fputchar は，文字 c を灯ゴ⑽/に出力します。 

fputchar (c) は， fputc(c, 饥 tow/) と同じです。 

戻り値 成功した場合， fputchar は文字 c を返します。エラーの場合は EOF を返 

します。 

可搬性 fputchar は UNIX システムで使用できます。 

閲連項目 fgetchar, putchar 
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fputs 


ストリームに文字列を出力します。 


機能 

形式 

プロトタイプ 

解脱 

戻り価 

可撤性 

間連項目 
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# include く stdio . h 〉 

int fputs (const char * s , FILE * stream ) \ 


stdio.h 


fputs は，ヌル文字で終わる文字列 s を，指定の出カストリーム stream へ 
コピーします。改行文字はつけず，また最後のヌル文字はコピーされませ 


fputs は，成功した場合は®:後に# f いた文字を返し，エラーの場合は EOF 
を返します。 


fputs は UNIX システムで使用でき， ANSIC と互換性があります。 K&R 
でも定我されています。 


fget 8, gets，puts 
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fread 


機能 ストリームからデータを読み込みます。 

形式 # include く stdio . h 〉 

size t fread (void * ptr , size t size , size t FILE * stream ) 


プロトタイプ stdio.h 


解脱 fread は， n 個のデータ（各データは 5 故ハ•イトの大きさ）を指定の入カス 

トリームから読み込んで， p // •が指すブロックに格納します。 

読み込まれるバイト数の合計は ( nxsize ) となります。 

ptr は ，どんなオブジェクトでも指すことができるように宣言されていま 

す。 

戻り 値 成功した場合， fread は実際に読み込んだデータの個数を返します（バイト 

数ではありません）〇ファイルエンドまたはエラーの場合には，データ数よ 
り小さな値 （0 のこともあります）を返します。 

可撤性 fread はすべて UNIX システムで使用でき ， ANSI C と互換性がありま 

す。 

関連項目 fopen , fwrite , printf , read 
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free 


機能 割り当て済みのブロックを解放します。 

形式 void free (void * block ) \ 

プロ トタイプ stdlib . h , alloc.h 

解脱 free は， calloc , malloc ， realloc の呼び出しで以前に確保されたブロック 

を解放します。 block には，そのメモリブロ ッ クの先頭八イトのアドレスが 
入っていなければなりません。 

戻り値 戻り値はありません。 

可搬性 free は UNIX システムで使用でき ， ANSI C と互換性があります。 

M 連項目 calloc ， freemem ， malloc , realloc , strdup 
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freemem 


機能 割り当て済みの DOS メモリブロックを解放します。 

形式 int freemem (unsigned segx ) : 

プロトタイプ dos.h 

解脱 freemem は，以前の allocmem の呼び出しで確保されたメモリブロックを 

解放します。從容ズには，そのブロックのセグメントアドレスを指定しま 
す。 

戻り値 freemem は，成功した場合には0を返します。エラーの場合には -1 を返し， 

err / io に ENOMEM (メモリが不足した）をセットします。 

閲連項目 allocmem , free 
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freopen 

機能 ストリームを置き換えます0 

形式 # include く stdio . h 〉 

FILE * freopen (const char * filename ， const char * mode , 

FILE * stream ) \ 

プロトタイプ stdio.h 

解脱 freopen は，オーブンストリーム於/ "earn を，指定のファイルに S きかえま 

す 。 stream ( i , そのオーブンが成功したかどうかに関係なくクローズされ 
ます。 • 

freopen は， stdin , stdout % 於み rr に結びつけられているファイルを変更す 
るのに便利です。 

freopen の呼び出しで使用される文字列 mode は， 次の値のいずれかです。 

r 統み出し輿用としてオーブンする。 

⑷ 擀き込み用として作成する。 

a 追加用。ファイルの終わりに辦き込むようにオーブンする 0 

ファイルが存在しない場合は苒き込み用として作成する。 
r + 既存ファイルを更新（読み出し/軎き込み）用として作成す 

る。 

新規ファイルを更新用として作成する。 

追加用としてオーブンする0ファイルの終わりから更新用と 
してオーブンする（ファイルが存在しなければ作成する）〇 

指定ファイルがテキストモードでオーブンあるいは作成されることを指定 
するには， morfe の値の最後に f をつけます （"， vv + r など)。同様に，バ 
イナリモードを指定するには， morfe の値の最後に6をつけます（勃 ， a + 
6など)。 

t または6が wo みに指定されていない場合は， モー ドはグローバル変数 
fmode によって決まります。 fmode が0 BINARY にセットされてい 
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れば，ファイルはバイナリモードでオーブンされます。尸 morfe が0 
TEXT がセットされていれば，テキストモードでオーブンされます。定数 
0_...は， fcntl.h で定義されます。 

ファイルが更新用にオーブンされていると，そのストリームに対して入力 
と出力が行なえなす。しかし，出力のあとで， fseek あるいは rewind を行 
なうことなしに入力を行なうことはできません。また入力のあとで， 
fseek ， rewind , ファイルの終わりを検出する入力のいずれかを行なうこと 
なしに出力を行なうこともできません。 

戻り値 成功した場合 ， f reopen は引数びれ洲を返します。エラーの場合は NULL 

を返します。 

可搬性 freopen は UNIX システムで使用でき ， ANSI C と互換性があります。 

間連項目 fclose , fdopen , fopen ， open , setmode 

例 fopen を参照してください。 
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frexp 


機能 

形式 

ブロトタイプ 

解脱 

戻り値 

可搬性 
閣連項目 


172 


double の変数を仮数部と指数部に分割します。 


# include < math . h > 

double irexp (double int * exponent ) : 
math.h 

frexp は，引数ズ（もとの double 値）から，ズ= wx2 n となるような仮数 
m(0.5 以上 1 未満の double) と整数値/?を計算します 0 frexp は ， exponent 
が指す整数に n の値を格納します。 

frexp は仮数 m を返します 0 

frexp のエラー処理は， matherr 関数を使って変更することができます 0 
frexp は UNIX システムで使用でき， ANSI C と互換性があります。 


exp , ldexp 
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fscanf 


機能 ストリームから書式つき入力を行ないます。 

形式 # include < stdio . h > 

int fscanf (FILE * stream ， const char 本 format [, address ”"]、 


プロトタイプ stdio.h 

解脱 fscanf は， 一; 里の入カフィールドをスキャンして，一度に1文字ずつストリ 

ームから文字を统み込みます。次に，引数 format によって指される弃式文 
字列中の冉式指定にしたがって，各フィールドを冉式化します。煅後に， 
Jbrmcu の後に統く 各引数が示しているアドレスに，冉式化した入力を格納 
していきます。冉式文字列中の冉式指定の個数は，その後に絞くアドレス 
の数と同じでなければなりません。 

冉式指定も含めて，詳細な悄報については scanf の解説を参照してくださ 

い0 

fscanf は，通常の フィールドの 終了（ホワイト スペース） に達する前に， 
フィールドの スキャンをやめる場合があります。また，いくつかの理由か 
ら入力を終了してしまうこともあります。こうした問題については 8 canf 
の解説を参照してください。 

戻り値 fscanf は，正しくスキャンし，変換し，格納した入カフィールドの数を返 

します。戻り値には，値を格納しなかった入カフィールドの数は含まれま 
せん。 

ファイルエン ドを読み込もうとした場合は，戻り値は EOF になります。値 
を格納した フィ ー ル ドがなかった場合は，戻り値は0になります0 

可搬性 fscanf は UNIX システムで使用でき， K & R で定義されています 。 ANSI 

C とも互換性があります。 

関連項目 atof ， cscanf ， fprintf ， printf , scanf , sscanf , vfscanf , 

vscanf , vsscanf 
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fseek 


機能 ストリーム上のファイルポインタを移動します。 

形式 # include く stdio . h 〉 

int fseek (FILE * stream , long int offset , int whence ) : 

プロトタイプ stdio.h 

解脱 fseek は，が ream に結びつけられているファイルポインタを， W ⑼ ce で指 

定されたファイルの位蓝から， offset バぺ 卜離れたところに位 til づけます。 
テキストモードのストリームでは， offset は0か， ftell によって返された値 
でなければなリません。 

は，0,1, 2のいずれかでなければなりません。この3つの定数は次 
のようなシンボリック定数で表されます （ stdio . h の中で定義されていま 
す）。 


wnence 

位置 

SEEK SET (0) 

ファイルの初め 

SEEK CUR (1) 

現在のファイルボインタの位蓝 

SEEK END (2) 

フアイルの終わり 




fseek は， ungetc がブッシュバックした文字は捨て去ります。 

fseek は，ストリーム I / O に対して使用します。 ファイルハンドル I / O に 

は lseek を使ってください。 

更新用にオーブンされたファイルに対しては， fseek を呼び出した後は，入 
力 • 出力どちらでも行なうことができます。 

戻り値 成功した場合， fseek は0を返し，エラーの場合は0でない値を返します。 
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可撤性 fseek はすべての UNIX システムで使用でき， ANSIC と互換性がありま 

す。 

関連項目 feetpos , fopen ， fsetpos ， ftell ， lseek ， rewind ， setbuf，tell 


例 


#include <stdio.h> 


/* ファイルストリーム内のバイト败を返す*/ 
long filesize(FILE *8tream) 

{ 

long curpos,length; 


curpos _ ftell(stream); 
f8eek(8tream f OL, SEEK_END); 
length _ ftell(stream); 
f8eek(8tream f curpos, SEEK_SET); 
return(lenght); 


main() 

< 

FILE *8tream; 

stream _ fopen( •MYFILE.TXT* 
printfCfilesize of MYFILE.TXT is 21d- 
•bytesVn* f filesize(stream)); 


プログラム出力 


filesize of MYFILE.TXT is 15 bytes 


Turbo C 標準関数 リファレンス 
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fsetpos 


ストリーム上のファイルポインタの位置を設定します < 


形式 


# include く stdio.h〉 

int fsetpos (FILE * stream , const fpos t * pos ) 


プロトタイプ stdio.h 


fsetpos は， stream に結びつけられているファイルボインタを新しい位茬 
にセットします。新しI、位置は，その stream に対して fgetpos を前回呼び 
出したときに得られた値です〇 fsetpos は， stream が指しているファイルの 
ファイル終了標識をクリアし，そのファイルに対する ungetc の効果を無 
効にします。 fgetpos を呼び出した後は，そのファイルに対して，入力また 
は出力を行なうことができます。 


戻り値 


fsetpos は成功した場合〇を返します。失敗した場合は〇以外の値を返し 
errno に0以外の値をセットします。 


可撤性 


fsetpos は ANSI C と互換性があります, 


関連項目 


fgetpos, fseek, ftell 
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fstat 


機能 オーブンファイルの情報を得ます。 

形式 # include < sys ¥ stat . h > 

int fstat (int handle , struct stat * statbuf ) : 

プロトタイブ sys ¥ stat.h 

解脱 fstat は，に結びつけられているオーブンファイルまたはディレク 

トリにに関する情報を， stat 檐造体の中に格納します。 
statbuf は， stat 構造体 ( sys ¥ stat . h の中で定我されている）を指していま 
す。その怫造体の中には次のようなフィールドが含まれています。 

st mode オーブンファイルのモードに関する悄報を与えるビットマス 
ク 

st_dev そのファイルがあるディスクのドライブ番号，またはファイ 

ルがデ/、•イス上にある場合にはファイルハンドル 
st rdev st dev と同じ 
stnlink 整定数1にセット 

st size オーブンファイルの大きさ（バイト数） 
st atime オーブンファイルの一番最近修正された日時 
st miime st atime と同じ 
st ctime st atime と同じ 

stat 構造体には，これ以外にフィールドが3つありますが， MS - DOS では意 
味を持たないので省略します。 

ビットマスクはオーブンファイルのモードに関する情報を含んでおり，各 
ビットは次のような意味を持っています， 

次のビットのうち，いずれか1つがセットされます。 

SJFCHR handle がデバべ スを参照している場合 
S IFREG 通常のファイルが/によって参照されている場合 


Turbo C 標準関数 リファレンス 


177 



戻り値 


関連項目 
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次の一方または両方のビットがセットされます。 

S_I WRITE ユーザが害き込み許可を得ている場合 
SJREAD ユーザが読み込み許可を得ている場合 

ビットマスクには，さらに読み込み/害き込みビットも含まれています。こ 
れらは ファイルの 許可モードにしたがって セッ トされます。 


fstat は，そのオーブンファイルに関する悄報をうまく得られた場合は0を 
返します。エラーの場合（情報が得られなかった）は-1を返し ， errno IZ 
EBADF (ファイルハンドルが正しくない）をセットします。 

access ， chmod，stat 
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ftell 


機能 

形式 

ブロトタイプ 

解脱 

戻り価 

可搬性 

関連項目 

例 


現在のフアイルポインタを返します。 


# include く sdtio.h> 

long int ftell (FILE * stream )； 


stdio.h 

ftell は， stream 中の現在のファイルポインタの位®を返します。オフセッ 
卜はファイルの先頭からバイト単位で数えます。 

ftell が返した値は，それに絞く fseek の呼び出しで使用することができま 
す0 


ftell は，成功した場合，現在のファイルポインタ位 S を返します。エラー 
の場合は -1 L を返し， errm > に正の値をセットします。 


ftell はすべての UNIX システムで使用でき， ANSI C と互換性がありま 


す0 


fgetpos , fseek , fsetpos , lseek ， rewind，tell 
fseek を参照してください。 
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ftime 


機能 

形式 

プロトタイプ 
解脱 


戻り値 

互換性 
閣連項目 
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現在の時刻を timeb 構造体に格納します。 


# include <sys¥timeb.h> 

void ftime (struct timeb * buf ) \ 

sys¥timeb.h 

ftime は現在の時刻を決定し，如/によって指される timeb 構造体の各フ 
ィールドを埋めます。 timeb 構造体は， time ， millitm , timezone , dstflag ( T > 
4 つのフイールドからなっています。 

■ time フィールドは，グリニッジ標準時 ( GMT ) 1970年1月1日00 : 00 : 
00からの経過秒数を与えます。 

■ m /7//7 m フィールドは，ミリ杪単位で time の端数を表わします。 

■ "me 的/^フィールドは， GMT とローカルタイムとの差を分単位で示 
します。この値は GMT から西に向かって計算されます。 ftime はこの 
値を， tzset 関数によってセットされたグローバル変数 timezone から 
取り出します。 

■ dstflag っ八 ールドは，その時間带において * 時間が有効でない場合 
にはゼロに，その時間带において*:時間が有効な場合にはゼロでない 
値にセットされます。 

注意： ftime は tzset を呼ひ•出します。 ftime を使用することが明らかな場 
合には， tzset を呼び出す必要はありません。 

ありません。 


ftime は UNIX システム V で使用できます。 


asctime ， ctime ， gmtime ， localtime ， stime , time , tzset 
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例 


#include <8tdio.h> 

#include <8y8¥timeb.h> 


main() 

{ 

struct timeb buf； 
ftime(&buf)； 

printfCZld Seconds since 1-1-70 GMT¥n B t buf .time)； 
printf(*plus Zd millisecondsVn^ t buf.millitm); 
printfCld Minutes from GMT¥n_, buf.timezone); 
printf(-Daylight savings Zs in effect¥n* f 
buf.dstflag ? *i8* : "is not ")； 
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fwrite 


機能 ストリームにデータを與きます0 

形式 # include く stdio . h 〉 

size t fwrite (const void * ptr ，size t size , size t «,FILE * stream ) : 
プロトタイプ stdio.h 

解脱 fwrite は，個のデータ（各データは hze バイトの大きさ）を指定の出力 

ストリームに追加します。 " r が指すデータが出力されます。 

搿き込まれるバイト数の合計は ( nxsize ) となります。 

ptr は， どんなオブジェクトでも抬せるように宣言されています。 

戻り値 成功した場合，実際に#き込んだデータの個数を返します（バイト数では 

ありません）。エラーがあった場合には，データ数より小さな値を返しま 
す。 

可撤性 fwrite はすべて UNIX システムで使用でき ， ANSI C と互換性がありま 


関連項目 fopen , fread 
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gcvt 


機能 

形式 

プロトタイプ 

解脱 

戻り値 
可撤性 

M 連項目 



•動小数点数を文字列に変換します。 


# include < dos . h > 

char * gcvt (double value , int ndec 、char * buf ) : 


stdio.h 


gcvt は， va / we をヌルで終わる ASCII 文字列に変換し，その文字列を如/ 

に格納します。 gcvt は，可能であれば， FORTRAN の F 変換に則して， 

ndec 桁の有効数字を生成します。 F 変換が不可能な場合は， printf の E 形 

式で（ブリント可能なように）生成します。後ろに絞く意味のない〇は文字 
列に含まれません。 

gcvt は， * w / が指す文字列のアドレスを返します。 
gcvt は UNIX システムで使用できます。 

ecvt，fcvt 
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geninterrupt 


機能 ソフトウェア割り込みを生成します。 

形式 # include < dos . h > 

void geninterrupt(int intr num ) : 


プロトタイプ dos.h 


解脱 geninterrupt マクロは，爪に指定された割り込みに対するソフト 

ウェアトラップを引き起こす働きをします。呼び出し後のすべてのレジス 
夕の状態は，呼び出された割り込みに依存します。 

戻り値 ありません。 

可搬性 geninterrupt は 80 x 86 アーキテクチャに特有のものです。 

間連項目 bdos , bdosptr , getvect , int 86, int 86 x , intdos , intdosx , intr 


184 


getc 


機能 

形式 

プロトタイプ 

解脱 

戻り価 

可撤性 

閗連項目 


ストリームから1文字を得ます。 


# include く stdio.h 〉 

int getc(FILE * stream ) : 


stdio.h 


getc は，指定の入カストリームから次の1文字を読み込んで，そのストリー 
ムのフアイルポインタをインクリメントするマクロです。 

成功した場合， getc は読み込んだ文字を符号拡張せずに int 型に変換して 
返します。ファイルエンドまたはエラーの場合は EOF を返します。 

getc は UNIX システムで使用でき， ANSI C と互換性があります。 K&R 
でも定義されています。 

fgetc, getch, getchar, getche, gets, putc, putchar, unsretc 
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getcbrk 


機能 

形式 

プロトタイプ 

解脱 

戻り値 

可撤性 

関連項目 
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コントロールブレークの設定を得ます。 

mt getcbrk (void) : 

dos.h 

getcbrk は， DOS のシステムコール 0x33 を使って，現在のコントロールブ 
レークチェックの設定を返します。 

getcbrk は，コントロールブレークチェックがオフなら〇，オンなら 1 を返 

します。 

getcbrk は MS - DOS に特有の関数です。 

ctrbrk，setcbrk 
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getch 

機能 キーボードからエコーバックなしで文字を読み込みます。 

形式 int getch (void) : 

プロトタイプ conio.h 

解脱 getch は，コンソールから直接1文字を読み込む関数です。エコーバックは 

しません。 getch は stdin を使用します。 

戻り値 getch は，キーボードから說み込んだ文字を返します。エラーの戻り値はあ 

りません。 

可搬性 Ketch は MS - DOS に特有の関数です。 

関連項目 cgets , fgetc , getc , getchar , getche , getpass , kbhit , putch , un^etch 
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getchar 


機能 

形式 

プロトタイプ 

解脱 

戻り値 

可撤性 

間連項目 
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stdin から 文字を読み込みます。 

# include く stdio.h 〉 
int getchar (void )； 

stdio.h 


getchar は，ストリーム stdin 上の次の 1 文字を返すマクロです。 

これは， getc (がと定義されています。 

成功した場合， getchar は読み込んだ文字を符号拡張せずに int 型に変換 
して返します。ファイルエンドまたはエラーの場合は EOF を返します。 


getchar は UNIX システムで使用でき ， ANSI C と互換性があります。 K & 
R でも定栽されています。 


fgetc , fgeichar , getc , getch ， getche f putc , putchar , ungetc 
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getche 


機能 キーボードからエコーつきで文字を読み込みます。 

形式 int getche ( void ) ； 

プロトタイプ conio.h 

解脱 getche は，キーボードから1文字を說み込み，現在のテキストウィンドウに 

エコーバック します 。 getche li BIOS を使用します。 

戻り値 getche は読み込んだ文字を返します。 

可撤性 getche は MS - DOS に特有の関数です。 

間連項目 cgets , cscanf , fgetc , getc , getch , getchar , kbhit , putch , un^etch 
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getcurdir 

機能 指定したドライブのカレントディレクトリを得ます。 

形式 int getcurdir (int drive ，char * directory ) \ 



dir.h 

getcurdir は，指定ドライブのカレント作業ディレクトリの名前を将ます。 
み/把にはドライブ番号（〇=カレント， 1 = A ，.. J を指定します0 
directory は， ヌルで終わるディレクトリ名が格納される，長さ MAXDIR 
のメモリ領域を指します。ディレクトリ名にはドライブ名は含まれず，先 
頭に円記号¥もつきません。 

getcurdir は，成功した場合は0を返し，エラーの場合は-1を返します。 
getcurdir は MS - DOS に特有の関数です。 

chdir ， getcwd, 泛 etdisk , mkdir , rmdir 
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getcwd 

機能 現在の作業ディレクトリを得ます 0 

形式 char * getcwd (char * buf y int bujlen ) \ 

プロトタイプ dir.h 

解脱 getcwd は，現在の作業ディレクトリ（ドライブ名も含む）の フルパス 名を 

得る関数です。 致± bu / len 文字まで buf の中に格納します。フルバス名の 
良さ（缎後のヌル文字まで）が/より長い場合はエラーになります。 
buf が NULL の場合は自動的に malloc が呼び出され， bujlen バイ ト分の 
バッファが割り当てられます 0 後で, getcwd が返した値を引数として free 
関数を呼び出せば，このバッファを解放することができます。 

戻り値 getcwd は次のような値を返します。 

■ が NULL でなかった場合，成功すれば 6 w / を返し，失敗すれば 
NULL を返します。 

■ buf が NULL だった場合は，割り当てたバッファへのボインタを返 
します。 

エラーの場合は NULL を返し，グ ローバ ル変数 errno に次のいずれかの 
値をセットします。 

ENODEV 指定のデバイスがない 

ENOMEM メモリが不足した 
ERANGE 結果が範囲を越えた 

可撤性 getcwd は MS-DOS に特有の関数です。 

閲連項目 chdir , getcurdir , getdisk , mkdir , rmdir 
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getdate 


機能 

MS-DOS の日付を得ます。 

形式 

# include <dos.h> 


void getdate ^struct date * datep) \ 

ブロトタイプ 

dos.h 


解脱 getdate は，システムの現在の日付を，ぬ rep が指す date 構造体に格納し 

ます。 

date 構造体は次のように定義されています。 

struct date { 
int da_year 
char da_day 
char da mon 
) ~ 

戻り値 ありません。 

可搬性 getdate は MS-DOS に特有の関数です。 

閣連項目 ctime ， gettime, setdate, settime 


/* 年 */ 
/* 日*/ 
/* 月 */ 
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ay f s date is 2d/Zd/2d¥n* f 
ay.dajrear # today•da mon fl 




getdfree 


機能 ディスクの未使用領域の大きさを得ます。 

形式 # include < dos . h > 

void getdfree (unsigned char drive ，struct dfree 木 dtable ) : 


ブロトタイプ dos.h 


解脱 getdfree は，め vwe で指定したドライブ（〇 =デフォルト， 1 = A , •••) のデ 

ィ スクに関する悄報を，ゴ如 A/e が指す dfree 構造体に格納します。 
dfree 構造体は次のように定義されています。 


struct dtree ( 

unsigned df_avail ； 
unsigned df_total; 
unsigned df_bsec ； 
unsigned df_sclu85 
)5 


/* 使用可艫なクラスタ » */ 
/* tt クラスタ败 */ 

/* 1 セクタのバイト数 */ 

/* 1 ク，スタのセクタ数 */ 


戻り値 getdfree は値を返しません。エラーの場合は， dfree 構造体のガ sclus に 

-1 が セツ トされます。 

可撤性 getdfree は MS-DOS に特有の関数です。 

関連項目 getfat , getfatd 
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getdisk 


機能 カレントドライブを得ます。 

形式 int getdisk ( void ) ; 

プロトタイプ dir.h 

解脱 getdisk li , カレントドライブを得て，整数値 （0 = A :，1 = B :, 2 = 

を返します。 DOS のシステムコール 0 x 19 と同じです。 

戻り値 getdisk は，カレントドライブ番号を返します。 

可搬性 getdisk は MS - DOS に特有の関数です。 

間連項目 getcurdir , getcwd , setdisk 

例 getcurdrive を参照してください 
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getdta 


デイスク転送アドレスを?#ます< 


形式 


cnar far * getdta(void) 


ブロトタイプ dos.h 


解脱 


getdta は，ディスク転送アドレス （ DTA ) の現在の設定を返します。 
スモール，ミデイアムのメモリモデルでは，セグメントは現在の データ セ 
グメントであるとみなされます。 C のみを使用していればそうなりますが， 
アセンブリ言語ルーチンを使用すると，ディスク転送アドレスはどんなハ 
ードウエアアドレスにも設定することができます。 

コンパクト，ラージ，ヒユージのメモリモデルでは， getdta が返すアドレ 
スは正しいハードウエアアドレスで，ブログラムの外側に位逋づけられて 
いることもあります。 


戻り値 


getdta は，現在のデイスク転送アドレスを指す f ar ポインタを返します 


可搬性 


getdta は MS - DOS に特有の関数です。 


間連項目 setdta 
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getenv 

機能 環境から文字列を得ます。 

形式 char + getenv (const char * name )； 

プロトタイプ stdlib.h 

解脱 getenv は，指定された環境変数の値を返します。環境変数名は大文字/小 

文字どちらで# T いてもかまいませんが，等号 （=) を含めてはいけません。 
指定された環境変数が見つからない場合は， getenv は空文字列を返しま 
す。 

戻り値 成功した場合， getenv は⑽脱に結びつけられている値を返します。指定 

した name が環境の中で定我されていない場合は， getenv は空文字列を返 
します。 

注意： 環境変数を直接変更することはできません。環境の値を変史したい 
場合は， putenv 関数を使ってください。 

可搬性 getenv は UNIX システムで使用でき ， ANSI C と互換性があります。 

関連項目 em ; iron (変数）， getpsp , putenv 
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例 


# include <8tdio.h> 

#include <stdlib.h> 


main() 

{ 

char *path f *dunmy ■ NULL; 

path _ getenvCPATH*); 
dummy - getenv(■DUMMY*); 

printfCPATH - Zs¥n\ path); 
printf('old value of DUMMY: Zs¥n" 
(dummy ― NULL) ? ■★none 食 _ 
putenv(•DUHHY-TURBOC-); 
dummy - getenv (*DUMMY*); 
printf("new value of DUMMY: Zs¥n" 


ブログラム出力 


PATH _ Ct¥BIN;C:¥BIN¥DOS;C:¥ 
old value of DUMMYi *none* 
new value of DUMMY: TURBOC 


x dummy); 


dummy); 
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getfat 


機能 ファイルアロケーションテーブル情報を得る 

形式 # include <dos.h> 

void getfat (unsigned char drive 、 struct iatinfo * dtable ) : 


プロトタイプ dos.h 


解脱 getfat は， rfWve で指定されたドライブ(〇 =デフォルト， 1= A , 2 = B,..J 

のファイルアロケーションテーブル （ FAT ) から悄報を取り出します0 

dtable は， 悄報を格納する fatinfo 媾造体を指します。 

getfat が情報を格納する fatinfo 構造体は次のように定義されています。 


struct fatinfo ( 
char f 1 solus 
char fi_fatid 
int fi 一 nclus 
int fi 一 by sec 
)5 


/*1 クラスタのセクタ败 */ 
/* FAT-id バイト */ 

/* クラスタ数 */ 

/* 1 セクタのバイト数 */ 


戻り値 ありません。 


可搬性 getfat は MS - DOS に特有の関数です。 

間連項目 getdfree , getfatd 
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getfatd 


機能 フアイルアロケーシヨンテーブル情報を得ます。 

形式 # include < dos . h > 

void getfatd (struct fatinfo * dtable ) \ 


プロトタイプ dos.h 


解脱 getfatd は，デフオルトドライブのファイルアロケーションテーブル 

( FAT ) から情報を取り出します。 dtable は、 情報を格納する fatinfo 構 
造体を指します。 

getfatd が悄報を格納する fatinfo 構造体は次のように定我されています。 


struct fatinfo { 
char fi_8clu8 
char fi_fatid 
int fi^nclus 
int fi bysec? 
>5 


/*1 クラスタのセクタ数 */ 
I* FAT-id バイト */ 

I* クラスタ数 */ 

/*1 セクタのバイト数 */ 


戻り値 ありません。 


可搬性 getfatd は MS - DOS に特有の関数です。 

閲連項目 getdfree , getfat 
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getftime 



アイルの日付と時刻を得ます。 


解脱 getftime は，オーブンされている handle に結びつけられているディ スク 

ファイルのファイル時刻•日付を取り出します。 ftimep が指している ftime 
m 造体に, ファイル時刻•日付が格納されます。 
ftime 構造体は次のように定義されています。 

struct ftime { 


unsigned ft_tseci 

5s 

/* 

秒 （ 2 秒単位） 

*/ 

unsigned 

65 

卜 

分 

*/ 

unsigned ft_houri 

5s 

/* 

轉 

貪 / 

unsigned ft 一 day ! 

5s 

/* 

B 

*/ 

unsigned ft_month! 

4 ; 

/* 

月 

*/ 

unsigned ft_jeari 

7s 

/* 

年 -1980 

*/ 


戻り値 成功した場合， getftime は 0 を返します。 

エラーの場合は-1を返し， errno に次のいずれかをセットします。 

EINFNC 無効なファンクション番号 
EBADF ファイル番号が正しくない 

可搬性 getftime は MS-DOS に特有の関数です。 

関連項目 open , setftime 
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getpass 


機能 バスワードを読みます。 

形式 char * getpass (const char * prompt )； 

ブロトタイプ conio.h 

解脱 getpass は，ヌル文字で終わる文字列；をブロンブトとして表示し， 

システムコンソールからエコーバック なしでハ •スワー ドを読み込みます 0 
ヌル文字で終わる最离8文字（ヌル文字は含めない）までの文字列を指すポ 
インタを返します0 

戻り偭 戻り値は静的文字列へのポインタなので，呼び出されるごとに上冉きされ 

ます。 

可撤性 getpass は UNIX システムで使用できます. 

関連項目 getch 
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getpsp 


機能 

形式 

プロトタイプ 

解脱 

戻り値 
可搬性 

M 連項目 


プログラムセグメントブレフイツクスを得ます。 

unsigned getpsp (void) : 


dos.h 


getpsp は， DOS のシステムコーノ U0x62 を使って，ブログラムセグメントブ 
レフイクス ( PSP ) のセグメントアドレスを得ます。 

この呼び出しは， MS - D 0 S 3 •ズにのみ存在します。 MS - DOS 2.ズでは，ス 
タートアップコードがセツトするグローハ•ル変数 jwp の値を，このかわり 
に使うことができます。 


getpsp は PSP のセグメントアドレスを返します。 


getpsp は MS-DOS 3. x に特有のものです。これより前のバージョンでは 
動作しません。 

Retenv , / wp (変数） 
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gets 


櫬能 

形式 

プロトタイプ 

解脱 


戻り値 

可搬性 
間連項目 

例 


stdin から 文字列を読み込みます。 


char + gets (char + s ) : 


stdio.h 


gets は，標準入カストリーム stdin から 、復帰文字で終わる文字列を読み込 
み， J に格納します。復帰文字は J の中ではヌル文字 （¥0) に置き換えら 
れます。 

scanf とは違って gets では入力文字列中にホワイトスペース（空白，タブ) 
があってもかまいません。 get は復帰文字に出会ったところで統み込みを 
やめ，それまでに説み込んだすべての文字を j に コビーし ます。 

成功した場合， gets は文字列引数 j を返します。 ファイルエンド あるいは 
エラーの場合は NULL を返します。 

gets は UNIX システムで使用でき， ANSI C と互換性があります。 

cgets , ferror , fgets , fputs , getc , puts 

#include <8tdio.h> 

main() 

{ 

char buff[133 】； 

puts(•Enter a string ： •); 
if (gets(buff) I- NULL) 

printfCString - f Z f ¥n B f buff )； 
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gettime 


機能 

形式 

プロトタイプ 

解脱 


戻り値 

可撤性 

関連項目 
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システム時刻を得ます。 


# include < dos . h > 

void gettime ^struct time * timep ) \ 
dos.h 


gettime はシステムの現在の時刻を， timep が指す time 構造体に格納しま 

す。 

time 構造体は次のように定義されています。 


struct time ( 

unsigned char 
unsigned char 
unsigned char 
unsigned char 


ti_hour; 
ti hund; 
ti sec ； 


/* 分 */ 
/* 轉 */ 
/* 1/100 秒*/ 
/* 秒 *1 


ありません。 


gettime は MS - DOS に特有の関数です。 


g ： eidate 9 setdate 9 settime 9 stime , time 
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getvect 


機能 割り込みベクタエントリを得ます。 

形式 void interrupt(* getvect(int interruptno )) 〇 : 


プロトタイプ dos.h 


解脱 8086ファミリイのすベてのプロセッサは，割り込みベクタのセットを持っ 

ており，これには〇〜255の番号がふられています。各べクタの中の4バイト 
値は，割り込み関数が38かれている場所を示すアドレスです。 
getvect は， interruptno で指定された割り込みべクタの値を統み出し，その 
値を，割り込み関数を指す （ far ) ボインタとして返します。 interruptno の 
値は〇〜255でなければなりません。 

戻り愐 Ketvect は， interruptno で指定された割り込みベクタの現在の 4 バイト値を 

返します。 

可搬性 getvect は MS - DOS に特有の関数です。 

間連項目 disable , enable , geninterrupt , setvect 
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例 


# include <stdio.h> 
#include <dos.h> 


/* getvect example */ 


void interrupt (*oldfunc)(); 
int looping - 1; 

/* get_out - this is our new interrupt routine */ 

void interrupt get_out() 

{ " 

I* restore to original interrupt routine */ 
8etvect(5,oldfunc); 
looping - 0 ; 

> 

/* capture_prt8cr - installs a new interrupt for 
<Shift><PrtSc> */ 

I* arguments s func -- new interrupt function pointer */ 

void capture_prt8cr(void interrupt (*£unc)()) 

{ 

/* save the old interrupt */ 

oldfunc _ getvect(5 )5 

/^install our interrupt handler */ 

8etvect(5 f func); 


void main () 


put8("Press <Shift><Prt Sc> to terminate*) : 
/* capture the print screen interrupt 食 / 
capture_prt8cr(get_out); 

/* do noting ♦/ 
while (looping); 

puts(•Success*); 


208 


第 2 章 Turbo C ライブラリ 


getverify 


機能 DOS のベリファイフラグの状態を返します。 

形式 int getverify ( void ) : 


ブロトタイプ dos.h 


解脱 getverify は，ベリファイフラグの現在の状態を得ます。 

ベリファイフラグはディスクへの出力を制御します 0 ベリファイがオフの 
ときには害き込みの照合（ベリファイ）は行なわれず，ベリファイがオン 
のときはすべてのディスクへの冉き込みにおいて，データが適切に*き出 
されたかどうかを確かめるために照合が行なわれます。 

戻り価 getverify は，ベリファイフラグの現在の状態（〇か 1 ) を返します。 

〇 =ベリファイフラグオフ 
1=ベリファイフラグオン 

可搬性 getverify は MS - DOS に特有の関数です。 

閣連項目 setverify 
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getw 

機能 ストリームから整数を読み込みます。 

形式 # include く stdio.h〉 

intgetw(FILE * stream ) \ 

プロトタイプ stdio.h 

解説 getw は，入カストリーム价從爪から次の整数を読み込みます。 g e t w は, 

ファイルの中の境界（アラインメント）を考慮しません。 

getw は，テキストモードでオーブンされたストリームに対しては使用す 

べきではありません。 

戻り愐 getw は，入カストリーム上の次の数を返します。 ファイルエン 

ドあるいはエラーの場合は EOF を返します。 EOF は getw が通常の値と 
して返すものなので， ファイル エンドあるいはエラーを検出するためには， 
feof や ferror を使う必要があります。 

可搬性 getw は UNIX システムで使用できます。 

閲連項目 putw 
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gmtime 

機能 日付および時刻をグリニッヂ時間に変換します。 

形式 # include く time . h 〉 

struct tm * gmtime (const time t * timer ) : 

プロトタイプ time.h 


gmtime { J , time が返した値のアドレスを引数にとり，分解された時刻が 
含まれている tm 型の構造体へのポインタを返します。 gmtime は ， GMT 
(グリニッジ標準時）への変換を行ないます。 
long W のグローバル変数 timezone It, GMT と地方標準時との差を秒•中. 
位で保持している必要があります （ PST — 太平洋標准時の場合には8 x 
60 x 60)。グローバル変数 daylight ( i , 夏時間の期間中にのみ〇以外の値を 
とります。 

W 造体 tm は， time . h の中で以下のように定義されています。 


struct tm { 
int tm_8ec ； 
int tm min ； 
int tm_hour; 
int tm 一 mday; 
int tm mon; 
int tm_year; 
int tm_wday ； 
int tm_yday; 
int tm 一 isdst; 

)； 


これらは， 24 時間制の時刻，日 （1 〜 31), 月 （0 〜11)，辎日（日辎が〇)， 
年の下2桁（年-1900)，年内での日（〇〜365),夏時間かどうかのフラグ（夏 
時間の間は0以外の値）を示しています。 


gmtime は，時刻が分解されて入っている構造体を指すボインタを返しま 
す。この構造体は静的データで，呼び出しが行なわれるごとに上害きされ 
ます。 
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可搬性 


gmtime は UNIX システムで使用でき ， ANSI C と互換性があります。 


関連項目 

例 


asctime, ctime, ftime, localtime ， stime ， time, tzset 


linclude <8tdio.h> 
#include <8tdlib.h> 
#include <time.h> 


main() 



struct tm *t 
time 一 t 8 


ime 

ec8 


ptr; 



timezone - 8 * 60 * 60; 


/*1970-01-01 00:00:00 からの縫遍秒败を得る */ 
time(&8ec8now )； 



/* GMT に * 操 */ 


timeptr ■ gmtimeC&secsnov )； 
printfCThe date is Zd-2d-19Z02d¥n*, 

(timeptr •> tm_mon) + 1 9 timeptr -> tm mday t 
timeptr •> tm_year) 5 

printfCGreenwith Mean Time is Z02dZ02d:Z02d¥n¥n tf f 


imeptr •> tm_hour f timeptr •> tm min f 
imeptr -> tm sec); 


プログラム出力 


The date is 2-2-1988 
Greenwitch Mean Time is 20:44:36 
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harderr 



harderr は，現在のブログラムに対するハードウエアエラーハンドラを定 
めます。このエラーハンドラは，割り込み 0 x 24 が起こったときに呼び出さ 
れます（割り込みにについては， MS - DOS ブログラマーズリファレンスマ 
ニユアルを参照してください)。 

そのような割り込みが起きたときに， Aam / fer が指す関数が呼び出されま 
す。ハンドラ関数は次のような引数をともなって呼び出されます。 

handler(int errval,int ax, int bp, int si )； 

errvat は， DOS によって DI レジスタにセットされる エラーコー ドです。 
ax ， bp ， si は， DOS が AX ， BP ， SI レジスタにセットする値です。 

■の：は， デイスクあるいは他のデバイスのどちらで エラーが 起きたの 
かを示します。 の:が 負でない値であればディスクエラ ーを 示し，負で 
あれば他のデバイスエラ ーを 示します。ディスクエラ ーの場合，ロズ と 
OxOOFF の AND をとると，エラーの起きたドライブ番号（1=ん2 = 
B ，...） を得ることができます。 

■如とぶ/の2つで，エラーの起きたドライブのデバイスドライ ハ•ヘッダ 
を指します。 


handler が指している関数が直接呼ひ•出されることはありません 。 harderr 
が，その関数を呼び出す DOS 割り込みハンドラを確立します。 

peek と peekb を使うと，このドライバヘッダからデハ•イスに関する 情報 
を得ることができます。 
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戻り値 
可搬性 
関連項目 
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ドライ八へッダは， poke あるいは pokeb によって変更することはできま 
せん0 

ハン ドラの中では1から OxC までの DOS コールを発行することができま 
すが，これ以外の DOS コールは MS . DOS をこわすことになります。特 
に，すべての C 標準 I / O あるいは UNIX エミュレーション I / O を呼び出 
すことはできません。 

ハンドラは，0 (無視)，1(再試行)，2 (異常終了）のいずれかの値を返さ 
なければなりません。 

ありません。 


harderr は MS - DOS に特有の関数です。 


hardresume , handretn . peek , poke 
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例 


/include <stdio.h> 
/include <dos.h> 


#define DISPLAY_STRING 0x09 
#define IGNORE 0 
#define RETRY 1 
/define ABORT 2 

int handler(int errval f int ax 9 int bp, int si) 

{ 

char msg(25J; int drive; 

/* デバイスエラー */ 

if (ax < 0 ) 

< 

/* DOS フアンクシヨン 0 - OxOC のみが使用可齟 
bdosptr(DISPLAY_STRING t -device errors$' 0 
hardretn(-l); /* 呼び出しプログラムに霣る * 

) 

drive ■ (ax & OxOOFF); 

sprintf(msg f "disk error on drive Ic$* f f A f + • 
bdosptrCDISPLAY^STRIHG, msg t 0); 

return(ABORT); /* 呼び出しプログラムを具常終 


main() 

{ 

harderr(handler) ; 

printf('Make sure there is no disk in drive At 
printf("Press a key when ready••.Vn，>; 
getchO; 

printf("Attempting to access As¥n*)? 
fopenCA ： ANY.PIL B t *r")5 


ブログラム出力 

Make sure there is no disk in drive A ： 
Pless a key when ready" • 

Attempting to access As 
disk error on drive A 
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hardresume 


機能 

形式 

ブロトタイプ 

解脱 


戻り値 
可撤性 
間連項目 
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ハードウヱアエラーハンドラ関数です。 


void hardresume (int axret ) \ 


dos.h 


harderr によって確立されたエラー ハン ドラは， hardresume を呼び出し 
て DOS へ制御を戻すことができます 0 hardresume の a ズ ref (結果コード） 
は，異常終了 （2), 再試行 （1), 無視 （0) のいずれかの値をもちます。異 
常終了は， DOS 割り込み 0 x 23 (コントロールブレーク割り込み）の呼び出 
しによって行なわれます。 

ハンドラは，0 (無视 )， 1(再试行)，2 (異常終了）のいずれかの値を返さ 
なければなりません。 

ありません。 

hardresume は MS - DOS に特有の関数です。 

harderr, hardretn 
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hardretn 


機能 

形式 

ブロトタイプ 
解脱 

戻り値 

可搬性 

関連項目 

例 


ハー ドウ ヱアエラーハンドラ 関数です 0 

void hardretn (int retn ) : 


dos.h 


harderr によつて確立されたエラー ハン ドラは， hardretn を呼び出して, 
直接アブリケーシヨンブログラムに戻ることができます。 

ハンドラは，0 (無视 )， 1(再試行)，2 (異常終了）のいずれかの値を返さ 
なければなりません。 

ありません。 


hardretn は MS-DOS に特有の関数です。 


harderr , hardresume 


harderr を参照してください。 
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hypot 


機能 直角三角形の斜辺の長さを計算します。 

形式 # include < math . h > 

double hypot (double x , double y ) \ 

プロトタイプ math.h 

解脱 hypot は，次の式を満たすような z の値を計饵します。 

パ=ズ2 +少2かつ Z > = 〇 

これは，直角三角形の直角をはさむ2辺の長さ x と y がわかっている場合 
に，斜辺の長さを求めることと等しくなります。 

戻り値 成功した場合， hypot は z を double で返します。エラーの場合（オーバー 

フローなど）は HUGE_VAL を返し， errm > に次の値をセットします。 

ERANGE 結果が範囲を越えた 

hypot のエラー処理は， matherr 関数を使って変更することができます。 
可撤性 hypot は UNIX システムで使用できます。 
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inport 

機能 

形式 

プロトタイプ 

解脱 

戻り値 
可搬性 
間連項目 


ハードウヱアボートから 1 ワードを読み込みます。 

# include く dos.h> 
int inport(int port id) \ 

dos.h 

inport は， portid に 指定した人カポートから 1 ワード統み込みます。 
inport は， I 充み込んだ値を返します。 
inport は 80x86 フアミリイに特有の関数です。 

inportD ， outport, outportb 
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inportb 


機能 

形式 

プロトタイプ 

解脱 


戻り値 

可撤性 

関連項目 
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ハードウヱアボートから1バイト読み込みます。 
unsigned char inportb Unt port id ) : 

dos.h 


inportb は， por/W に指定した入カポートから i バイトを読み込むマクロで 
す。 

inportb は， dos . h がインクルードされている場合は，インラインコードに 
展開されるマクロとして扱われます。 

dos . h をインクルードしていない場合や， dos . h はインクルードしても 
inportb マクロを# undef している場合には関数として扱われます。 

inportb は，読み込んだ値を返します。 

inportb は 80 x 86 ファミリィに特有の関数です。 

inport , outport , outportb 
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int86 


機能 8086ソフトウェア割り込みを行ないます。 

形式 # include < dos . h > 

int int 86 (int intno , union REGS * inregs , union REGS * outregs ) \ 
プロトタイプ dos.h 

解脱 int 86 は，引数/ Wmo で指定された8086ソフトウェア割り込みを実行しま 

す。ソフトウェア割り込みを実行する前に， inregs 中の値を各レジスタにコ 
ピーします。 

ソフトウェア割り込みが終わると， int 86 は，現在のレジスタの内容を 
o^regs にコピーし，キヤリーフラグのステータスを 0 U t re g S の xx fl ag つ 
イールドにコビーし，さらに8086のフラグレジスタの値を outregs の x . 
f^gs フイ ールドにコピーします。 

キャリーフラグがセットされている場合は，通常はェラーが起きたことを 
意味します。 

inre gs は， o ^ regs と同じ携造体を指していてもかまいません。 

戻り 値 int 86 は，ソフトウェア割り込み終了時の AX レジスタの値を返します。キ 

ャリーフラグがセットされているとき ( outregs -) x . flag != 0 ) はェラーを 
意味し， tfoserr / io にェラーコードがセットされます 

可撤性 int 86 は 80 x 86 アーキテクチャに特有の関数です。 

閲連項目 bdos , bdosptr , geninterrupt ， int 86 x , intdos , intdosx , intr 
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#define BIOS 0x18 


/* カーソル位置の設定 （ x 桁， y 行 ）*/ 
void gotoxy(int x f int y) 

{ 

union REGS regs ； 
reg8.h.ah - 0x13; 

regs.x.dx - (((y •1 )* 80> + x -1> * 2; 
int86(BI0S f &reg8 f &regs) : 
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int86x 


機能 

形式 

ブロトタイプ 

解脱 


戻り値 

可搬性 
閣連項目 


8086ソフトウヱア割り込みインターフェースです。 

# include <dos.h> 

int int86x (int intno, union REGS * inregs, union REGS * outregs, 

struct SREGS * segregs ) : 


dos.h 


int 86 x は，引数で指定された8086ソフトウヱア割り込みを実行しま 
す。ソフトウェア割り込みを実行する前に， inregs 中の値を各レジスタにコ 
ピーします。 int 86 x はさらに， segregs->x.ds と segregs->x.es の値を対応す 
るレジスタに3¢きます。これによって， far ポインタを使うブログラムや， 
ラージデータモデルのブログラムで，ソフトウェア割り込みの実行中に使 
用するセグメントを指定できるようになります。 

ソフトウェア割り込みから戻ると， int 86 x は，現在のレジスタの内容を 
outregs にコピーし，キヤリーフラグのステータスを outregs の x.cflag つ 
ィ ールドにコピーし，8086のフラグレジスタの値を outregs の x.flags つべ 
ールドにコピーします。 int 86 x はさらに， DS を回復し， segregs->es と 
• y 印/•作 5 -〉めに対応するセグメントレジスタの値をセットします。キャリー 
フラグがセットされる場合は，通常はエラーが起きたことを意味します。 
int 86 x は，デフオルトのデータセグメントとは異なる DS の値や， ES の値 
を必要とする8086ソフトウ x ア割り込みを呼び出す場合に使うことができ 
ます。 


int 86 x は，ソフトウェア割り込み終了時の AX レジスタの値を返します。 
キヤリーフラグがセツトされているとき （ outregs -〉 x.flag != 〇)はエラー 
を意味し， rfoserrm ? にエラーコードが セッ トされます。 


int 86 x は 80 x 86 アーキテクチャに特有の関数です。 


bdos ， bdosptr , gemnterrupt ， intdos ， intdosx ， int 86, intr , segread 
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intdos 


機能 DOS 割り込みインターフェースです。 

形式 # include < dos . h > 

mt intdos (union REGS * inregs ， union REGS * outregs ) : 


プロトタイプ dos.h 


解脱 intdos は， DOS 割り込み 0 x 21 を実行して，指定の DOS ファンクションを 

呼ひ•出します 0 fnregs->h.a! の彳&によって, 呼び出される DOS ファンクシ 
ョンが 決まります 0 

intdos は， DOS ファンクションを実行する前に， mre 取中の値を各レジス 
夕にコビーします。 

0 x 21 割り込みから戻ると， intdos は，現在のレジスタの内容を⑽び级 s に 
コピーし，キヤリーフラグのステータスを outregs の x.cflag つベ ールドに 
コピーし，さらに8086のフラグレジスタの値を outregs の x.Jlags フイール 
ドにコビーします。 

キヤリーフラグがセットされている場合は，通常はエラーが起こったこと 
を 意味し ます。 

inregs outregs と同じ怫造体を指していてもかまいません。 

戻り値 intdos は， DOS フアンクションコール終了時の AX レジスタの値を返し 

ます。 キヤリーフラグがセットされているとき ( outregs -) x.cf lag != 0) 

はエラーを意味し， doserrno にはエラーコードがセットされます。 

可撤性 intdos は MS - DOS に特有の関数です。 

関連項目 bdos , geninterrupt ， int 86, int 86 x , intdosx , intr 
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例 /include <8tdio.h> 

#include <dos.h> 

/* ファイル名の m 錄： 成功すれば ()• 失败すると0以外を返す */ 


int delete_fiie(char near 貪 filename) 

{ 

union REGS regs; 
int ret ； 

regs.h.ah - 0x41 ； /* ファイル */ 

regs.x.dx - (unsigned) filename; 
ret _ intdo8(&reg8 f &regs); 

/* キヤリーフラグがセツトされていればエラー */ 

return(reg8.x.cflag 7 ret : 0); 


main() 

{ 

int err; 


err ■ delete^file(•NOTEXIST.$$$•) 5 
printfCAble to delete H0TEXIST .$$$： Xs¥n\ 
(Ierr) 7 -YES •: -HO*); 


プログラム出力 


Able to delete N0TEXIST .$$$： NO 


Turbo (標準関数 リファレンス 
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intdosx 


機能 DOS 割り込みインターフェースです。 


形式 # include < dos . h > 

int intdosx (union REGb * inregs 、 union REGS * outregs , 

struct SREGS * segregs ): 


プロトタイプ dos.h 


解脱 intdosx は， DOS 割り込み 0 x 21 を実行して，指定の DOS ファンクションを 

呼ひ•出します。 /> ire が-〉 A . a / の値によって，呼び出される DOS ファンクシ 
ョンが決まります。 intdosx は， DOS ファンクションを実行する前に， 
inregs 中の値を各レジスタにコピーし， segregs -〉 x . ds と segregs -> x.es の値 
を対応するレジスタに;«きます。これによって， far ポインタを使うブログ 
ラムや，ラージデータモデルのブログラムで，ファンクションの実行中に 
使用するセグメントを指定できるようになります。 

0 x 21 の割り込みが終わると， intdosx は，現在のレジスタの内容を⑽び e 供 
にコビーし，システムのキャリーフラグのステータスを outregs の x.cflag 
フイールドにコピーし，さらに8086のフラグレジスタの値を outregs の x . 
flags フィールドにコピーします。 intdosx はさらに， DS を回復し， segregs 
-> 打と segregs->ds に対応するセグメントレジスタの値をセットします。 
キャリーフラグがセットされている場合は，通常はエラーが起こったこと 
を意味します。 

intdosx は，デフォルトのデータセグメントとは異なる DS の値や， ES の 
値を必要とする DOS ファンクションを呼び出す際に使うことができます。 
inregs outregs と同じ W 造体を指していてもかまいません。 

戻り値 intdosx は， DOS ファンクションコール終了時の AX レジスタの値を返し 

ます。キャリーフラグがセットされているとき（⑽ぴ egsAx.cflag != 0) 

はエラーを意味し， rfoserr / io にはエラーコードが セッ トされます。 

可搬性 intdosx は MS - DOS に特有の関数です。 
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関連項目 


bdos ， geninterrupt , int 86, int 86 x f intdos ， intr , segread 


例 #include <stdio.h> 

/include <dos.h> 

/* ファイル名の削成功すれば0 , 失败すると0以外を返す .*/ 

int delete_file(char far *filename) 

{ 

union REGS regs; 
struct SREGS sregs ； 
int ret; 

regs.h.ah - 0x41 ； /* ファイル m 除 */ 

regs.x.dx _ FP 一 OFF(filename); 
sregs.ds _ FP 一 SEG(filename); 
ret _ intdosx(ireg8 f &regs )； 

i * キヤリーフラグがセツトされていればエラー */ 
return (regs.x-cflag ? ret : 0 )； 


main() 

{ 

int err; 

err _ delete_file(-NOTEXIST.$$$•) - 
printfCAble to delete NOTEXIST .$$$： Zs¥n« f 
(!err) ? *YES •: m H 0 9 )； 


プログラム出力 


Able to delete N0TEXIST .$$$： NO 
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intr 


機能 もう 1 つの8086ソフトウェア割り込みインターフェースです。 

形式 # include < dos . h > 

void intr(int intno , struct REGPACK + preg ) : 

プロトタイプ dos.h 


解脱 intr 関数は，ソフトウェア割り込みを実行するためのもう 1 つのインター 

フェースです。引数 rnmo で指定された8086ソフトウヱア割り込みを生成 
します。 

intr は，ソフトウェア割り込みの実行の前に， REGPACK 構造体* pr 印の 
中の各値を，対応するレジスタにコピーします。ソフトウヱア割り込みが 
終わると， intr は，現在のレジスタの値を， フラグも含めて preg の中にコ 
ピーします。 

intr へ渡される引数は次の2つです。 


intno 実行されるべき削り込み番号 
P^g 以下の値を持つ構造体のアドレス 

( a ) 呼び出し前は，入力するレジスタの値 

( b ) 割り込み後は，現在のレジスタの値 


REGPACK 檐造体は， dos . h の中で次のように定義されています。 


struct REGPACK 
{ 

unsigned r_ax f r_bx f r_cx, r_dx; 
unsigned r_bp f r_si f r 二 di, r_ds # r_es f reflags ； 
>5 ~ 


戻り値 intr は値を返しません。 REGPACK 構造体* preg に，割り込み後のレジス 

夕の値が入っています。 


可撤性 
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g ： eninterrupt , int 86, 
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ioctl 


機能 i/o デバイスを制御します。 

形式 int ioctl(int handle 、 int func [, void * argdx , int argcx ]) \ 

プロトタイプ io.h 

解脱 これは， DOS のシステム コール 0 x 44 ( IOCTL ) への直接のインター フエー 

スです。具体的なファンクシヨンは， func の値によって次のよ うになりま 
す0 


0 デバイスコント ロール データを得る 

1 デバイスコントロールデータをセットする （ arg ゴズの値） 

2 argdx が指すアドレスに， argcx バイト統み込む 

3 arg 办が指すアドレスから， a /^ズバイト#き出す 

4 2とほば同じ，ただし/をドライブ番号として扱う （0= デフ 
ォルト， 1= A など） 

5 3とほぼ同じ，ただしみ am / fe をドライブ番号として扱う （0 = デフ 
ォルト， 1= A など） 

6 入カステータスを得る 

7 出カステータスを得る 

8 メディアの交換性のテスト （ DOS 3. X のみ） 


11 リトライ回数の設定 （DOS 3. x のみ) 


ioctl は，デバイスチャネルに関する情報を得るために使用します。 func が 
0，6，7では，通常のファイルも指定できます。それ以外の値の場合には 
EINVAL エラーを返します。 

システムコール 0 x 44 の引数や戻り値に関する詳細は， MS - DOS のブログラ 
マーズリファレンスマニュアルを参照してください。 

引数 argdx および argcx はオブションです。 
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ioctl は，特殊なファンクシヨンに対する MS - DOS 2.0 デバイスドライバへ 
の直接的なインターフェースを提供します。この関数の厳密な動作は，各 
社のハードウヱアやデバイスによって異なり，サポートしていない場合も 
あります。 ioctl の使い方に関しては使用するシステムの BIOS に関するマ 
ニュアルを参照してください。 

戻り値 f 刪 が0あるいは1の場合，戻り値はデバイス情報 (IOCTL 呼び出しの DX 

レジスタの値）です。 

/ wm : が2〜5の場合は，戻り値は実際に転送されたハ•イト数です。 

ル/ ic が6〜7の場合，戻り値はデバイスステータスです。 

エラーが起きた場合は-1を返し， errno に次のいずれかの値を セッ トしま 
す。 

EINVAL 引数が正しくない 

EBADF ファイル番号が正しくない 

EINVDAT データが正しくない 

可撤性 ioctl は UNIX システムで使用できますが，引数や機能は異なります。 

UNIX バージヨン7とシステム III とでは， ioctl の使用法が異なります。 
MS-DOS で使用した ioctl 呼ひ•出しをそのまま UNIX で使用することは 
できません。また， MS-DOS マシン間の可搬性もほとんどありません。 
MS-DOS 3•ズで，の値として8と11の機能が追加されました。 

例 linclude < 8 tdio.h> 

/include <io.h> 

#include <dir.h> 

main() 

{ 

int stat; 

stat ■ ioctl(0 # 8,0,0) ； /* ファンクシ 3 ン 8 で，メディアが */ 

I * 交換性可 tt なかどうかを w ベる*/ 
printf ("Drive Zc Zs changeable%，• 

) getdiskO + , (stat _■ 0 ) ? .is ■: nof )； 

ブログラム出力 


Drive A is not changeable 
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isalnum 


機能 文字が英字あるいは数字であるかどうかを判定します。 

形式 # include <ctype.h> 

int isalnum (int c ) : 

プロトタイプ ctype.h 

解脱 isalnum は，テーブルを参照して， ASCII コード（整数値）の分類を行な 

うマクロです。判定の結果が)4であれば〇以外の数値を，偽であれば0を返 
します。 isa 丨 num は， isascii(c) が真の場合，または c が EOF の場合につ 
いてのみ定義されています。 

戻り値 isalnum は，（:が英字（/I〜 Z, a - z ) または数字 （0 〜 9) の場合に，〇以 

外の値を返します。 

可撤性 isalnum は UNIX システムで使用できます。 
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isalpha 


文字が英字であるかどうかを判定します, 


形式 


# include < ctype . h > 
int isalpha (int c ) : 


ブロトタイプ ctype.h 


解脱 


isalpha は，テーブルを参照して， ASCII コード（接数値）の分類を行なう 
マクロです。判定の結果が真であれば〇以外の数値を，偽であれば〇を返し 
ます。 isalpha は， isascii ( c ) が真の場合,またはが EOF の場合について 
のみ定我されています。 


戻り値 
可撤性 


isalpha は， c が英字（メ〜 Z ， a - z ) の場合に，0以外の値を返します。 
isalpha は UNIX システムで使用で衾ます。 
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isascii 

機能 文字が ASCII 文字であるかどうかを判定します。 

形式 # include < ctype . h > 

int isascii (int c ) : 

プロトタイプ ctype.h 

解脱 isascii は，テーブルを参照して ， ASCII コード （整数値）の分類を行なう 

マクロです0判定の結果が真であれば0以外の数値を，偽であれば0を返し 
ます。 

isascii は，すべての格数値に対して定義されています。 

戻り値 isascii は， c が〇〜127 (0 x 00 〜 0 x 7 F ) の範囲内にある場合に，0以外の値を 

返します。 

可搬性 isascii は UNIX システムで使用できます。 
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isatty 


機能 デバイスタイプをチヱックします。 

形式 int isatty (int handle ) \ 


ブロトタイブ io.h 


解脱 isatty は， handle が ，次に示すキャラクタデバイスのいずれかであるかど 

うかの判定を行ないます。 

■端末 

■コンソール 
■ブリンタ 
_シリアルボート 

戻り値 加 r ひは，デバイスがキャラクタデバイスの場合に〇以外の値を返し，それ 

以外は0を返します。 
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iscntrl 


機能 文字が制御文字かどうかを判定します。 

形式 # include < ctype . h > 

int iscntrl (int c ) : 


プロトタイプ ctype.h 


解脱 iscntrl は，テーブルを参照して， ASCII コード（整数値）の分類を行なう 

マクロです。判定の結果が真であれば0以外の数値を，偽であれば0を返し 
ます。 iscntrl は, isascii(c) が真の場合，または c が EOF の場合について 
のみ定義されています。 

戻り値 iscntrl は， c が削除文字 (0 x 7 F ) あるいは通常の制御文字 （0 x 00 〜 OxlF ) 

の場合に，0以外の値を返します。 

可搬性 iscntrl は UNIX システムで使用でき， ANSIC と互換性があります。 
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isdigit 


櫬能 文字が数字かどうかを判定します。 

形式 # include < ctype . h > 

int isdigit (int c )； 


プロトタイプ ctype.h 


解脱 isdigit は，テーブルを参照して， ASCII コード（整数値）の分類を行なう 

マクロです。判定の結果が真であれば0以外の数値を，偽であれば〇を返し 
ます。 isdigit は， isascii ( c ) が真の場合，または c が EOF の場合について 
のみ定義されています。 

戻り値 isdigit は， c が数字 (0-9) の場合に，0以外の値を返します。 

可撤性 isdigit は UNIX システムで使用でき ， ANSI C と互換性があります。 
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isgraph 


機能 文字がブリント可能文字かどうかを判定します。 

形式 # include く ctype . h 〉 

int isgraphunt c ) : 


プロトタイプ ctype.h 


解脱 isgraph は，テーブルを参照して， ASCII コード（整数値）の分類を行な 

うマクロです。判定の結果が輿であれば〇以外の数値を，偽であれば0を返 
します。 isgraph は， isascii ( c ) が戽の場合，または c が EOF の場合につい 
てのみ定義されています。 

戻り値 isgraph は， c が空白以外のブリント可能な文字の場合に，0以外の値を返 

します。 

可搬性 isgraph は， UNIX システムで使用でき ， ANSI C と互換性があります。 
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islower 


機能 文字が英小文字かどうかを判定します。 

形式 # include く ctype . h 〉 

int islowr(int c ) : 


プロトタイプ ctype.h 


解脱 islower は，テーブルを参照して， ASCII コード（整数値）の分類を行なう 

マクロです。判定の結果が真であれば0以外の数値を，偽であれば0を返し 
ます。 islower は， isascii ( c ) が真の場合,または c が EOF の場合について 
のみ定義されています。 

戻り値 islower は， c が小文字 ( a - z ) の場合に，0以外の値を返します。 

可撤性 islower は UNIX システムで使用でき， ANSIC と互換性があります。 K & 

R でも定義されています。 
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isprint 


機能 


文字がブリント可能文字かどうかを判定します, 


形式 


# include < ctype . h > 
int isprint (int c ) : 


ブロトタイプ ctype.h 


解脱 


isprint は，テーブルを参照して， ASCII コード（整数値）の分類を行なう 
マクロです。判定の結果が真であれば〇以外の数値を，偽であれば〇を返し 
ます。 isprint は， isascii ( c ) が寘の場合，または c が EOF の場合について 
のみ定義されています。 


戻り値 


isprint は， c がブリント可能な文字 （0 x 20 〜 0 x 7 E ) の場合に，0以外の俯 
を返します。 


可搬性 


isprint は UNIX システムで使用でき ， ANSI C と互換性があります。 
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ispunct 

機能 文字が区切り文字かどうかを判定します。 

形式 # include < ctype . h > 

int ispunct (int c ) : 

プロトタイプ ctype.h 

解脱 ispunct は，テーブルを参照して， ASCII コード（整数値）の分類を行なう 

マクロです。判定の結果が真であれば〇以外の数値を，偽であれば〇を返し 
ます。 ispunct は， isascii ⑷が真の場合，または c が EOF の場合について 
のみ定義されています。 

戻り値 ispunct は， c が区切り文字の場合 （ iscntrlorisspace ) に，0以外の値を 

返します。 

可搬性 ispunct は， UNIX システムで使用でき ， ANSI C と互換性があります。 
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isspace 


機能 文字が空白文字かどうかを判定します。 

形式 # include く ctype . h 〉 

int isspace unt c ) : 

プロトタイプ ctype.h 

解脱 isspace は，テーブルを参照して， ASCII コード（整数値）の分類を行なう 

マクロです。判定の結果が K であれば0以外の数値を，偽であれば0を返し 
ます 0 isspace は， isascii ( c ) が真の場合，または c が EOF の場合について 
のみ定義されています。 

戻り値 isspace は， c が、 空白，タブ，復帰，改行，垂直タブ，フォームフイード 

の場合に，0以外の値を返します。 

可撤性 isspace は UNIX システムで使用でき， ANSI C と互換性があります。 K & 

R でも定義されています。 
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lsupper 


機能 文字が英大文字かどうかを判定します。 

形式 # include く ctype . h 〉 

int lsupperunt c ) : 

プロ.トタイプ ctype.h 

解脱 isupper は，テーブルを参照して， ASCII コード（整数値）の分類を行なう 

マクロです。判定の結果が K であれば0以外の数値を，偽であれば〇を返し 
ます。 isupper は， isascii ( c ) が真の場合，または c が EOF の場合について 
のみ定義されています。 

戻り値 isupper は， c が英大文字（メ〜 Z > の場合に，0以外の値を返します。 

可撤性 isupper は UNIX システムで使用でき ， ANSI C と互換性があります。 K & 

R でも定我されています。 
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isxdigit 

機能 文字が 16 進数の表記文字かどうかを判定します。 

形式 # include く ctype . h 〉 

int isxdight(int c ) : 

プロトタイプ ctype.h 

解脱 isxdigit は，テーブルを参照して， ASCII コード（整数値）の分類を行なう 

マクロです。判定の結果が真であれば0以外の数値を，偽であれば〇を返し 
ます。 isxdigit は， isascii ( c ) が真の場合,または c が EOF の場合について 
のみ定義されています。 

戻り値 isxdigit は， c が16進数の表記文字 (0-9, A ^ F % a 〜 f ) の場合に，〇以 

外の値を返します 0 

可搬性 isxdigit は， UNIX システムで使用でき ， ANSI C と互換性があります。 
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itoa 


機能 

形式 


整数を文字列に変換します。 

char * itoa(int value , char * stringy int radix ) # 


プロトタイプ stdlib.h 

解説 itoa は，整数値 value の値をヌルで終わる文字列に変換し，結果を string に 

代入します。 

には，叩/敗を変換する際に使用する基底を指定します。 radix は， 

2〜36の値でなければなりません。 value が氮て • radix がであもと 、 string 
の最初の文字は負符号 （-) になります 3 

注意：於/^ぎ用に確保する領域は，返される文字列を格納するのに充分な 
大きさでなければなりません。 itoa の最大長は’肢後のヌル文字も含めて 
17文字です。 


戻り値 
M 連項目 


itoa は，文字列へのポインタを返します。エラーの戻り値はありません。 

Itoa , ultoa 
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kbhit 


機能 キーボードが押されたかどうかをチェックします。 

形式 int kbhit ( void ) ; 

プロトタイプ conio.h 

解脱 kbhit は，現在までにキーボードが押されたかどうかのチ x ックを行ない 

ます。押されたキーは， getch または getche で得ることができます。 

戻り値 キーボードが押されていれば， kbhit は0以外の値を返し，押されていなけ 

れば〇を返します。 

間連項目 getch , g：etche 
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keep 


機能 

形式 

プロトタイプ 

解脱 

戻り値 
可搬性 

M 連項目 


ブログラムを常駐させたまま終了します。 
void keep (unsigned char status , unsigned size ) : 


dos.h 


keep は， status を終了ステータスとして DOS に戻ります 0 このとき，ブロ 
グラムはメモリに常駐したままになります。ブログラムの大きさは size パ 
ラグラフにセットされ，残りのメモリは開放されます。 
keep は， TSR ブログラムをインストールするときに使用することができ 
ます。 keep は， DOS ファンクション 0 x 31 を使用します。 

ありません。 


KEEP は MS - DOS に特有の関数です。 

abort , exit 
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labs 


機能 

形式 

プロトタイプ 

解脱 

戻り値 
可搬性 
閬連項目 
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long の絶対値を与えます。 

# include < math . h > 
long int labs (long int x) : 

math.h, stdlib.h 

labs は， long 型の引数ズの絶対値を返します。 

labs は，ズの絶対値を返します。エラーの戻り値はありません。 

labs は UNIX システムで使用でき ， ANSI C と互換性があります。 

abs , cabs , fabs 
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ldexp 


機能 

形式 

ブロトタイプ 

解脱 

戻り値 

可搬性 

閻連項目 


ズを計算します0 


# include <math.h> 

double laexp (double ズ ， int exp): 


math.h 

ldexp は，ズ X 2 •砂を double で計算します。 
ldexp は，ズ X 2 exp の値を返します。 

ldexp のエラー処理は， matherr を通して変更することができます 
ldexp は UNIX システムで使用でき ， ANSI C と互換性があります。 

exp , irexp , modf 
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ldiv 


櫬能 

形式 

プロトタイプ 

解脱 


戻り価 
可搬性 
間連項目 

例 
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2 つの long の除讳を行ない，商と剌余を返します。 
# include く stdlib.h 〉 

ldiv t ldivdong int numer, long int aenom) \ 


stdlib.h 


ldiv は， 2 つの long の 除算を行なって，商と剰余を W / v_f 型で返します。 
numer が被除数， denom が除数です。 W/v r 型は long からなる構造体で， 
stdlib.h 中で次のように typedef 宣言されています。 

typeder struct { 

long quot; /* 商 *1 

long rem; /* H 余 */ 

)ldiv—t; 

ldiv は， quot m ) と rem (剰余）を要素に持つ構造体を返します。 


ldiv は ANSI C と互換性があります。 


div 


#include <stdlib.h> 
ldiv_t lx; 

main() 

{ 

lx ■ldiv(100000L f 30000 L>; 

printf( •100000 div 3000 0 ■ Zld remainder Zld¥n\ 
lx•quot•lxrem); 
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lfind 


機能 線形探索を行なぃます。 

形式 # include く stdlib . h 〉 

void * liind (const void * key , const void * base , 

size t * num ， size t width 、 

int ( * fcmp ) (const void *，const void *)); 

プロトタイプ stdlib.h 

解脱 lfind は，シーケンシャルレコードの配列内で，夕の値によって線形探索 

を行なぃます。探索には，ユーザ定我の比铰ルーチン { fcmp ) が使われま 
す。 

探索の対象となる配列は，レコード長がバイト，レコード数が 
* num Aa 於が指すアドレスから始まるものとして定義されます。 

f ⑽ P は， ユーザが定義する比較ルーチンを指すポインタです。比較ルーチ 
ンは， elem ! と elem 2 の2つの引数をとります。2つの引数はそれぞれ比較さ 
れる値を指します。比較関数は，2つの引数が指す項目 （* elem い elem 2) 
を比較し，その結果にしたがって整数値を返します。 

*/ cmp は，次のような値を返さなければなりません。 

_* eleml != * elem 2 の場合，〇以外 
■ * eleml == * elem 2 の場合，〇 

通常は， eleml は引数 Are 夕で， elem 2 は検索の対象となるテーブル内の項目 
を指します ofcmp が検索キーやテーブルの項目をどのように解釈するかは 
自由であり，ユーザが必要とする方法で定義することができます。 

民り値 lfind は， S 己列内で検索キーと一致した最初の項目のアドレスを返します 

一致する項目がなかった場合には NULL を返します。 

関連項目 bsearch , lsearch 
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localtime 

機能 日付およひ•時刻を構造体に変換します。 

形式 # include < time . h > 

struct tm * localtime (const time t * timer) 

プロトタイプ time.h 

解脱 localthne は， time が返した値のアドレスを引数にとり，分解された時刻 

が人っている構造体を指すポインタを返します。 localtime は，地方時間带 
の時刻を返し，夏時間の場合にはこれも考慮します。 
long 型の グローバル 変数は， GMT とその地方の標準時の差を 
秒単位で保持しています （ PST — 太平洋標準時の場合には8 X 60 X 60)。グ 
ローバ ル 変数 daylight は， 奥•時間の期間中にのみ〇以外の値をとるように 
なっています。 

構造体 tm は， time . h の中で以下のように定我されています。 

struct tm { 
int tm_8ec; 
int tm min ； 
int tm hour ； 
int tm 一 today; 
int tm 一 mon; 
int tm_year; 
int txn_wday ； 
int tm_yday ； 
int tm_i8d8t5 
>； _ 

これらは， 24 時間制の時刻，日 （1 〜 31), 月 （0 〜 11), 曜日（日曜が 0), 
年の下2桁（年-1900)，年内での日 （0 〜365)，夏時間かどうかのフラグ（夏 
時間の間は0以外の値）を示しています。 

戻り値 localtime は，時刻が分解されて入っている構造体を指すボインタを返し 

ます。この構造体は静的データで，呼び出しが行なわれるごとに上害きさ 
れます。 
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可撤性 


localtime は UNIX システムで使用でき ， ANSI C と互換性があります。 


関連項目 

例 


asctime , ctime , ftime ， gmtime , stime , time , tzset 

#include <8tdio.h> 

#include <8tdlib.h> 

/include <time.h> 


main() 



struct tm 
time t 8 


ime 

ecs 


ptr ； 




imezone ■ 8 食 60 食 60 ; 
ime(&8ec8now )； 


timeptr ■localtime(&sec8now )； 
printfCThe date is Id-Zd- 19102 d¥n* f 


((timeptr -> tm 
timeptr -> tm^jrear )； 
printf('Local time is Z02d:Z02d:Z02d¥n' 
timeptr •> hour, timeptr -> tm 一 e 
timeptr -> tm 一 sec); 


+ 1)# time •> tm_mday 


プログラム出力 


The date is 2-2-88 
Local time is 12:44:36 
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lock 


機能 

形式 

プロトタイプ 

解脱 

戻り値 
可搬性 

関連項目 
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ファイルシェアリングのロックをセットします。 


int lock(int handle, long offset 、 lone length) \ 


io.h 

lock は ， DOS 3 .ズのファイルシェアリング機構へのインターフェースを 
提供します。 

lock は，ファイルの任意の®なりのない領域に対して実行することができ 
ます。ロックされた領域に対して統み湃きするブログラムは，3回までその 
操作を再試行します。3回とも失敗した場合は，その呼び出しはェラーで終 
わることになります。 

lock は，成功した場合は0を返し，ェラーの場合は-1を返します。 

lock は MS - DOS 3.0 に特有の関数で，それより前のバージョンでは動作し 
ません。 

open , sopen , unlock 
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log 


機能 

自然対数を計算します。 

形式 

# include < math . h > 

double log (double x ) : 

プロトタイプ 

math.h 

解脱 

log は，ズの自然対数を計算します。 

戻り値 

log は，成功した場合は計算結果を返します。 

引数ズが〇以下であった場合は， log は HUGE VAL を返し， errno に次の 
做をセットします。 


EDOM 定義域エラー 


log のエラー処理は， matherr 関数を通して変更することができます。 

可搬性 

log は UNIX システムで使用でき ， ANSI C と互換性があります。 

関連項目 

exp , loglO , sqrt 
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loglO 

機能 常用対数を計算します。 

形式 # include <math.h> 

double loglO (double x) \ 

プロトタイプ math.h 

解脱 loglO は，ズの常用対数を計算します。 

戻り値 loglO は，成功した場合は計算結果を返します。 

引数ズが〇以下であった場合は， loglO は HUGE _ VAL を返し， ermo に次 
の値をセットします。 

EDOM 定義域エラー 

loglO のエラー処理は， matherr 関数を通して変更することができます 
可撤性 loglO は UNIX システムで使用でき ， ANSI C と互換性があります。 

関連項目 exp , log 


256 


第2章 Turbo C ライブラリ 


longjmp 


機能 ローカルでない goto を行ないます。 

形式 # include <setjmp.h> 

void longjmp(jmp buf jmpb, int retval ) : 


プロトタイブ setjmp.h 


解税 longjmp を呼び出すと，ゾを引数とする setjmp の前回の呼び出しでと 

らえられたタスクの状態が回復されます。そして ， set jmp が値 retval を返 
したかのようにリターンします。 

タスクの状態とは以下のものをいいます。 

■すべてのセグメントレジスタ （ CS , DS , ES ， SS ) 

■レジスタ変数 （ SI , DI ) 

■スタッ クボインタ ( SP ) 

■フレームポインタ （ FP ) 

■フラグ 


タスクの状態は，コルーチンを実現するために setjmp と longjmp が使用 
されるのに充分なものです。 

setjmp は， longjmp より前に呼び出しておかなければなりません。 8e tjmp 
を呼んで jmpb を 設定したルーチンは， longjmp が呼び出されるまではア 
クテイブなままでなければならず，リターンすることはできません。もし, 
そうしてしまった場合は，結果は予測できません。 

これらのルーチンは，プログラムの低レベルサブルーチンにおいて起こる 
エラーや例外を処理する際に便利なものです。 

longjmp は値0を返すことはできません。作⑽/に0を入れて渡すと， l ong j . 
mp はこれを1に置き換えます。 

戻り値 ありません。 
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可搬性 longjump は UNIX システムで使用でき ， ANSI C と互換性があります。 

閲連項目 setjmp , signal 


例 


/include <stdio.h> 

# include <setjmp.h> 

jmp 一 buf jumper; 

main() 

{ 

int value; 


value ■ 8etjmp(jumper); 
if (value 丨 _ 0 ) 

< 

printf("Longjmp with value Id¥n® f value); 



printf("About to call subroutine ••• ¥n B )； 
subroutine() : 


subroutine(> 

{ 

longjmp(jumper t l )； 


プログラム出力 


About to call subroutine … 
Longjmp with value 1 


258 


第 2 章 Turbo C ライブラリ 



lrotl 


機能 unsigned long の値を左へローテートします。 


形式 

unsigned long lrotl (unsigned long va/ t int 

count ) ； 

プロトタイプ 

stdlib.h 


解脱 

Jrotlli , 与えられた値 VY 7/ を，指定されたビ 
ートします〇 va / は unsigned long です。 

ット数 count だけ左へ ローテ 

戻り偭 

lrotl は， w / をビット左へ ローテー \ 

• した値を返します。 

閭連項目 

Irotr . rotl 


例 

rotl を参照してください。 
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lrotr 


機能 

形式 

プロトタイプ 

解脱 

戻り値 
M 連項目 

例 
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unsigned long の値を右へローテートします 0 


unsigned long lrotr ^unsigned long val t int count ) : 
stdlib.h 

lrotr は，与えられた値阳/を指定されたビッ ト数 cown / だけ右へローテ 
—卜します。⑽/は unsigned long です。 

」 rotr は，⑽/を count ビット右へローテートした値を返します。 

Irotl , rotr 

rotl を参照してください。 
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lsearch 


線形探索を行ないます。 

# include く stdlib.h 〉 

void * isearch (const void * key, void * base、 

size—t 木 num t sizej width, 
int ( * fcmp) (const void * ， const void *)); 

stdlib.h 

lsearch は，テーブル中の情報を検索します。 Search は線型探索を行なう 
ので，呼び出しの前にテーブルがソートされている必要はありません。んぴ 
が指している項目がテ-ブルの中に存在しない場合， lsearch はその項目 
をテーブルに追加します。 

疆 base H 検索するテーブルの基底 （0 番目の要素）を指します。 

■ m / m は，テーブル内の要素の個数を示す数値を指します。 

亀 width は， 1つの項目の大きさ（バイト数）を示します。 

■んひは，検索する項目（検索キー）を指します。 

,卿は， ユーザが定義する比較ルーチンを指すポインタです。比較ルーチ 
ンは2つの弓|数 （ efem /， elem 2) をと t ) ，この引数はそれぞれ比較される値 
を指します。比較関数は，2つの引数が指す項目 (本 el emI , 本 elem2 ) を 
比較し，その結果にしたがって整数値を返します。通常は， e ， eml は弓 I 数 
key て' は検索の対象となるテーブル内の項目を指します ◊ 

は，次のような値を返す必要があります。 

■ * eleml = = * elem 2 の場合，〇 
■* eleml != * eleml の場合，〇以外の値 

fCmp が検索キーやテーブルの項目をどのように解釈するかは g 由であり， 
ユーザが必要とする方法で定義することができまナ 


機能 

形式 

プロトタイプ 

解脱 
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戻り値 

可搬性 

関連項目 

例 
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lsearch は， テーブル 内 で 検索 キーと一致した 最初の項目のアドレスを返 
します。 

lsearch は UNIX システムで使用できます0 


bsearch, hind, qsort 

# include <8tdio.h> 

#include <8tdlib.h> 

# include <string.h> /* strcxnp の宜言のため */ 
/* カラーの番得を初期化 */ 

char *color8(10J - { ’Red' •Blue 、 •Green* 
int ncolors _ 35 

int color8cmp(char **argl f char **arg2> 

{ 

return(8trcmp(*argl f *arg2 ))5 


int addelem(char *color) 

< 

int oldn - ncolors; 

l8earch(&color 9 colors• (8ize_t *) &ncolors f 
sizeof(char *>• colorscmp); 
return (ncolors __ oldn )5 


main() 

{ 

int is 

char *key - "Purple* 5 


if (addelem(key)) 

printfCZs already in colors table¥n" f key )5 
else 

printf(*28 added to colors table, now Id colors¥n B f 
key f ncolors); 
printf("The colors:¥n - )? 
for (i _ 0; i < ncolors; i++) 
printfCZ8¥n* f colors[i]); 


プログラム出力 


purple added to colors table ， 
now 4 colors 
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lseek 




7 ァイルポインタを移動します。 

include <io.h> 

>ng lseek (int handle , long offset 、 int fromwhere ) 


jeek は， handle に結びつけられているファイルポインタを， f romwhere で 

指定された位置から 〇 力知 r バイト離れた位3 ¢に 移動します 。 fromwhere li 、 
0 ，1，2 のいずれかでなければなりません。 には， stdioh の中で 
定義されている次の3つのシンボリック定数を用いると便利です。 



戻り価 


lseek は，ポインタの新しい位置のオフセットを，ファイルの先頭からのバ 

イト数で返します。エラーの場合は- 1L を返し， ermo は次のいずれかにセ 
ットされます。 


EBADF ファイル番号が正しくない 

EINVAL 正しくない引数 

シークが行なえないデバイス（端末やプリンタ）に対しては，戻り値は未 
定義です。 


可搬性 


lseek は UNIX システムで使用できます。 
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関連項目 filelength , fseek ， ftell ， sopen f write , write 
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ltoa 


機能 

long 型を文字列に変換します。 

形式 

# include く stdlib.h 〉 

char * ltoa (long value, char * string, int radix) \ 

プロトタイプ 

stdlib.h 

解脱 

ltoa は， value の値をヌルで終わる文字列に変換し，結果を string に格納し 
ます。 


mrfiv には，を変換する際に使用する基底を指定します。 radix は， 

2 〜 36 の値でなければなりません。 value が負で radix がであると，文字 
列の股初の文字は負符号 （ -) になります。 


注意： が / かぎ用に確保する領域は，返される文字列を格納するのに充分な 
大きさでなければなりません。 ltoa が返す最大文字数は， 肢 後のヌル文字 
(¥0) も含めて 33 文字です。 

戻り価 

3 つの関数とも文字列へのボインタを返します。エラーの戻り値はありませ 
ん〇 

関連項目 

ltoa, ultoa 
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malloc 


機能 メインメモリを割り当てます。 

形式 # include く stdlib . h〉or # include く alloc . h 〉 

void * malloc (size t size ) : 


プロトタイプ stdlib . h ， alloc.h 

解脱 malloc は， C のメモリヒープから size バイ トのブロックを確保します。こ 

れによって，ブログラムは，必要なときに必要な 进 だけメモリを確保する 
ことができます。 

ヒープは，可変サイズのメモリブロックの動的割り当てに使用されます。 

木構造やリストと いった 多くのデータ W 造は，通常ヒープメモリに削り当 
てられます。 

スモールデータモデルでは，データセグメントの終わりからブログラムス 
タックの先頭までのすべての領域をヒープとして使用することができます。 
ただし，スタックトップの直前の256バイトは，アブリケーシヨン用のスタ 
ックの拡張領域と DOS が使用する領域として確保されているため除外さ 
れます。 

ラージデータモデルでは，ブログラムスタックを越えてメモリの物理的な 
最終位 ilf までのすベての領域がヒープとして使用可能です。 

戻り値 malloc は， Jire に指定した長さのメモリブロックを指すポインタを返しま 

す。要求したブロックを確保するだけのメモリが充分ない場合， malloc は 
NULL を返し，ブロックの内容はそのままになります。 

引数の場合には NULL を返します。 

可搬性 malloc は UNIX システムで使用でき ， ANSI C と互換性があります。 

関連項目 allocmem , calloc ， coreleft , farcalloc , farmalloc , free , realloc 
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例 


#include <stdio.h> 
/include <stdlib.h> 


typedef struct { 

/*•••*/ 

} OBJECT ； 

OBJECT *NewObject() 

{ 

return ((OBJECT *) malloc(sizeof(OBJECT))); 


void FreeObject(OBJECT *obj) 

{ 

free(obj )； 


main() 

{ 

OBJECT *obj; 

obj ■ NewObjectO; 
if (obj ― NULL) { 

printf("failed to create a new object¥n # ) 
exit(l )； 


free(obj )； 
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_matherr 


機能 

形式 

プロ 

解脱 


浮動小数点ェラーを処理します。 


# include < math . h > 

double matherr ( mexcep why t cnar 本 jun t 

double 本 arglp 、double 本 arg 2 p , double retval ) : 


タイプ math.h 

matherr は，すべての数学ライブラリ関数内のエラー処理において中心 
的に機能する関数です。 matherr は， matherr を呼び出して ， matherr 
が返す値を処理します。 jnatherr は， ユーザブロ グラムから庇抟呼び出す 
ことはできません。数学ライブラリのエラー処理は， matherr 関数をき 
換えることによってカスタマイズすることができます。 

数学ライブラリルーチンのいずれかでエラーが起こると，いくつかの引数 
とともに jnatherr が呼び出されます。 matherr は次の4つの処理を行な 
います。 


■渡された引数で exception 構造体を埋めます 0 

■ exception 構造体を指すポインタ e を引数として matherr を呼び出 
し， matherr がそのエラーを解決できるかどうかを調べます。 

■ matherr からの戻り値を調べて，次の処理を行ないます。 
matherr が0を返した （ matherr がそのエラーを解決できなかった） 
場合， matherr は errno をセットしてエラー メッ セージを出力しま 
す。 

matherr が0でない値を返した ( matherr がそのエラーを解決できた） 
場合は， matherr は何もしません。 

■もとの呼び出し側へ，を返します。 matherr は ， retval 
を，もとの呼び出し側へ返したい値に変更できることに注意してくだ 
さい0 
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— matherr が errno をセットする場合 （ matherr からの戻り値が 0) ，起こ 
つたエラーの種類 ( exception 構造体のび pe フィールド）を errno (値は 
EDOM か ERANGE ) に入れることになります。 

戾り 1 疆 一 matherr は，の値を返します〇この値は，初めは jnatherr に渡 

された引数 retval の値であり， matherr によって変更されることもありま 
す。 

数学関数の結果が MAXDOUBLE より大きかった場合，デフォルトでは 
retval は jnatherr に渡される前に， HUGE _ VAL に適切な符号をつけた 
ものにセットされます。数学関数の結果が MINDOUBLE より小さかった 
場合は，作 m ?/ は〇にセットされ， — matherr に渡されます。どちらの場合 
でも ， matherr が retval の値を変換しない場合は ， matherr が errno 
に ERANGE (結果が範囲外）をセットします。 

関連項目 matherr 
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matherr 


機能 ユーザが変更可能な数学エラーハンドラです。 

形式 # include く math . h 〉 

mt matherr (struct exception * e ) : 

プロトタイプ math.h 


解脱 


matherr は，数学ライブラリが生成したエラーを処理するために math ¬ 
err ルーチン によって 呼び出されます。 

matherr は，ユーザ独自の数学エラー処理ルーチンが必要な場合に，これ 
を S き換えて使用するフックとして提供されています（後で示す例を参照 
して〈ださい）。 

matherr は，数学関数が引き起こした定義域エラーおよび値域エラーを卜 
ラップするのに便利です。ゼロによる除烊などの浮動小数点の例外をトラ 
ッブすることはできません。こうしたエラーのトラップについては signal 
を参照してください。 

matherr を，独自のエラー処理ルーチン（あるタイブのエラーを捉えて解 
決する）として定務することができます。修正した matherr は，エラーを 
解決できなかった場合には0,解決できた場合には0でない値を返さなけれ 
ばなりません。 matherr が0でない値を返したときは，エラーメッセージは 
プリントされず， eriTio は変更されません。 

exception 怫造体は， math . h の中で次のように定義されています。 


struct exception { 
int type ； 
char ♦name; 
double argl, arg 2 . 


>； 


retval; 
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exception 構造体のメンバは次のようになっています。 


メンバ 意味 


ひ pe 起きた数学エラーのタイプ。 typedef 名— mexcep (後述) 

の中で定義された enum 型の値。 

name エラーを起こした数学ライブラリ関数の名前を持つ文字 

列を指すポインタ。 

叫 2 エラーを起こした引数。関数へ渡される引数が1つだけの 

場合は argl に入れる。 


retvaI そのエラーのデフオルトの戻り値。この値は変更するこ 


とができる。 



typedef 名— mexcep (これも math.h の中で定務されています）は，次に示 
すそれぞれの数学エラーに対応するシンボリ ッ ク定数を定我しています。 

シンボリック定数 数学エラー 


DOMAIN 

間数の領域に引数が入っていない。例： log (- l )。 

SING 

引数が特異性を引き起こす。例： pow (0,-2)。 

OVERFLOW 

引数のため，関数の結果が MAXDOUBLE を越える。 
例 ： exp (1 000) 0 

UNDERFLOW 

引数のため，関数の結果が MINDOUBLE を下回る。 
例 ： exp (-1000)。 

TLOSS 

引数のため，関数の結果の有効数字が減る。 

例： sin (10 e 70 ) o 


シンボリック定数 MAXDOUBLE , MINDOUBLE は values . h の中で定義 
されています。 

一 matherr を変更することはできないことに注意してください 。 mat herr 

は，多くの C ランタイムライブラリに含まれており， matherr を使用すれ 
ば可搬性を高めることができます。 
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戻り値 


可撤性 

閫連項目 

例 


UNIX スタイルの matherr のデフォルトの動作（メッセージをブリント 
して終了する）は， ANSI との互換性はありません。 UNIX スタイルを望 
むのであれば， TurboC のマスターデイスクに含まれている matherr . c を 
使用してください。 


matherr のデフォルトの戻り値は，エラーが UNDERFLOW あるいは 
TLOSS の場合には1,それ以外の場合には 0 です。 matherr は， e^retval 
を変史することもできます。変更した値は， matherr を経由してもとの呼 
び出し側に返されることになります。 

matherr が 0 を返した（エラーを解決することができなかった）場合は， 
jnatherr が errno をセットしてエラーメッセージを出力します （ math¬ 
err を参照してください）〇 

matherr が 0 でない値を返した（エラーを解決することができた）場合は, 
err/io はセツトされず，メッセージも出力されません„ 


matherr は，多くの C コンハ•イラで使用できますが， ANSI との互換性は 
ありません。 

メッセージをブリントして終了する UNIX スタイルの matherr は， 
Turbo C のマスターディスクに含まれている MATHERR.C で提供され 
ています。 


matherr 


これはユーザ疋義の matherrM 数で • sqrt に <| の 91 败が液された場合に 


sqrt がその值を 


義の ma 
ft 環す 


る « に負でない败值に * 换します • 


linclude <xnath.h> 


<8t ： 


#include <8tring*h> 


int 


exception *a) 


if (a •> type ― DOMAIN) 


if(8trcmp(a -> 


• ■8qrt_> __ 0> 


a -> retval 
return (1); 


sqrt (-(a -> argl)) 


return (0 )； 
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max 

機能 2 つの値の大きい方を返します。 

形式 # include く stdlib . h 〉 

(type) max(o, b) \ 

プロトタイプ stdlib.h 

解脱 max は， 2 つの値を比較して大きい方を返すマクロです。 2 つの引数と 関数 

の型は，同じものとして宣言されなければなりません。 

戻り値 max は，大きい方の値を返します。 

間連 項目 min 

例 /include <8tdlib.h> 

maln() 

{ 

int x _ 5; 
int y - 6 ； 
int z; 

z _ (int) max(z # y )； 

printf("The larger number is Id¥n*, z); 

ブログラム出力 

The larger number is 6 
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memccpy 


機能 

形式 

プロトタイプ 

解脱 

戻り値 

可撤性 

関連項目 
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メモリブロックをコピーします。 


# include <mem.h> 

void * memccpy (void * dest ， const void * src t int c t size t n ) : 


string.h, mem.h 

memccpy は， J / r から dest へ rt バイトのブロックをコピーをします。コビ 
一は，次の条件のいずれかが満たされると終了します。 

■文字 c が dest に初めてコビーされた。 

■ バイトがみ 订 に コピー された。 

memccpy は， c •がコピーされた場合はみ中の c の次のバイトを指すポ 
インタを返し，そうでない場合は NULL を返します。 

memccpy は UNIX システム V で使用できます。 

memcpy , memmove , memset 
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memchr 


機能 メモリブロック中で文字を検索します。 

形式 # include <mem.h> 

void * memchr (const void * s f int c 9 size t n ) : 


プロトタイプ string.h, mem.h 

解脱 memchr は， J が指しているメモリブロックの最初の/ 1 バイトの中で，文 

字(：を探します。 

戻り値 memchr は， J の中で最初に c が見つかった位; B を指すポインタを返しま 

す。見つからなければ NULL を返します。 

可搬性 memchr は UNIX システム V で使用でき ， ANSI C と互換性があります。 
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memcmp 

機能 2 つのメモリブロックを比較します。 

形式 # include < mem . h > 

void * memcmp (const void * sl t const void * s 2 t size t n ) \ 

プロトタイプ string . h , mem.h 

解脱 memcmp は，と W が指す 2 つのブロックの先頭から n バイ トを，各バイ 

卜を unsigned char として比較します。 

戻り 値 memcmp は，次のような値を返します。 

く0 W が W より小さい場合 

= 0 s / と W が等しい場合 
<0 W が W より大きい場合 

各ハ # イトは unsigned char として比較されるので，次の式は正の値を返し 
ます。 

memcmpC¥xPP - f a ¥x7V ,1) 

可撤性 memcmp は UNIX システム V で使用でき， ANSI C と互換性があります。 

間連 項目 memicmp 
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memcpy 


機能 

形式 

プロトタイプ 

解脱 

戻り値 
可撤性 
間連項目 


メモリブロックをコピーします。 

# include <mem.h> 

void * memcpy (void * dest ，const void + src t size t n ) : 
string.h, mem.h 

memcpy は ， jrc から dest へ n 八イ トの ブロックをコピー しま十 src ヒ 
dest がオーバーラップしている場合の動作は未定義です。 

memcpy は dest を返します。 

memcpy は UNIX システム V で使用でき ， ANSI C と互換性があります。 

memccpy , memmove , memset , movedata , movemem 
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memicmp 


概能 

形式 

プロトタイプ 

解脱 

戻り値 

可搬性 

間連項目 


2つのメモリブロックを文字ヶースを無视して比較します。 

# include <mem.h> 

int memicmp (const void * ざ /, const void * s 2 t size t n ) : 
string.h, mem.h 

memicmp は，と 52 が指す 2 つのブロックの先頭から "パイ トを，文字 
ヶース（大文字か小文字か）を無祝して比較します。 

memicmp は，次のような値を返します。 

<0 si が W より小さい 
= 0 W と W が等しい 

<0 s / が W より大きい 

memicmp は UNIX システム V で使用できます。 

memcmp 
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memmove 


機能 

形式 

プロトタイプ 

解脱 

戻り値 

可搬性 

M 連項目 


メモリ配列を操作する 


# include <mem.h> 

void * memmove (void * desi t const void * src t size t n ) : 
string.h.mem.h 

memmove は， jrc* から dest へ /? ハ * イト のブロックをコピー します。 vc と 
みがでオーバーラップしている場合でも，オーバーラップ部分は正しくコ 
ピーされます。 

memmove It aest を返します。 

memmove は UNIX システム V で使用でき， ANSI C と互換性がありま 

す。 

memccpy ， memcpy，movmem 
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memset 


機能 

形式 

プロトタイプ 

解脱 

戻り値 
可搬性 
閬連項目 


メモリブロックに指定された文字をセットします。 

# include <mem.h> 

void * memset (void * s t mt c, size t n) \ 
string.h, mem.h 

memset は，が指すブロックの先頭から ”バイ トに，文字(：をセットしま 
す。 

memset はを返します。 

memset は UNIX システム V で使用でき ， ANSI C と互換性があります。 

memccpy , memcpy , setmem 
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min 


2 つの値の小さい方を返します。 


機能 

形式 

ブロトタイプ 

解脱 

戻り値 

間連項目 

例 


# include く stdlib.h 〉 
(type) min (a, 6) : 

stdlib.h 


nun は， 2 つの値を比較して小さい方を返す マクロです。2 つの引数と関数 
の型は，同じものとして宣言されなければなりません。 

min は，小さい方の値を返します。 



#include <stdlib.h> 


main() 

{ 

int x - 5; 
int y - 6 ； 
int z ； 

z ■ (int) min(x f y )； 

printf("The smaller number is Id¥n" t z )； 


プログラム出力 


The smaller number is 5 
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mkdir 


機能 

ディレクトリを作成します0 

形式 

# include < dos . h > 

int mkdir (const char * path ) : 

プロトタイプ 

dir.h 

解脱 

mkdir は， pa/A に指定されたハ•ス名から，ディレクトリを新たに作成しま 

す。 

戻り値 

mkdir は，新しいディレクトリが作成できた場合0を返します。 

戻り値- 1 はエラーを意味し， errno に次のいずれか値がセットされます。 


EACCESS アクセスは否定された 

ENOENT そのようなファイルまたはデイレクトリはない 

閫連項目 

chdir , getcurdir , getcwd , rmdir 
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MKLFP 


機能 

形式 

プロトタイプ 

解脱 

戻り値 
関連項目 

例 


far ポインタを作ります。 

# include <dos.h> 

void far * MKFP(unsigned seg t unsigned ofs) \ 
dos.h 

MK_FP は，セグメント（贫ぎ）とオフセット （ o/jO から far ポインタを作 
り出すマクロです。 

MK FP は far ポインタを返します。 

FP OFF , FP SEG , movedata , segread 

FP OFF を参照してください 
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mktemp 

機能 ユニークなファイル名を作ります。 

形式 char * mktemp (char * template ) : 

プロトタイプ dir.h 

解脱 mktemp は， re / wp/aw が指す文字列を ユニークな ファイル名で逋き換え 

て， template を返します。 

tempUue li ， ’ A °6 個からなり，ヌルで終わる文字列でなければなりません 0 
6個の AT は， ユニークな 英字と1個のピリオドに S き換えられます。2個の英 
字，ピリオド，3個の英字になるわけです。 

新しいファイル名は， AA.AAA から始めて，ディスク上のファイルの名前 
を見て，同じ名前にならないように選ばれます。 

戻り 値 template がうまく得られた場合は， mktemp は文字列 template のアドレス 

を返します。そうでない場合は NULL を返します。 

可撤性 mktemp は UNIX システムで使用できます。 
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modf 


機能 

浮動小数点数を整数部と小数部に分割します。 

形式 

# include <math.h> 

double modf (double ズ， double * ipart ) : 

プロトタイプ 

math.h 

解脱 

modf は， double 型のズを 2 つの部分(整数部と小数部）に分割します 。 ipart 
が指す場所に整数部を格納し，小数部を関数値として返します。 

戻り値 

modf は，ズの小数部を返します。 

関連項目 

imod, Idexp 
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movedata 


機能 

形式 

プロトタイプ 

解脱 

戻リ偭 

関連項目 

例 
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バイトをコピーします。 

void movedata、unsigned srcseg 、 unsigned srcoff 、 unsigned dstseg ， 

unsigned dstoff r size 一 t w): 

mem.h,string.h 

movedata は，アドレス sres eg : srcoff から aj バイトを ， dstseg : dstoff 、こ 
コピーします。 

movedata は，メモリモデルに依存しないデータブロックの転送手段です。 
ありません。 

FP OFF, memepy，MK FP, movmem，segread 

/include <mem-h> 

#define RED_PLANE 0xA800 
char buf[80*400 】； 

I* グラフィツク VRAM の赤のプレーンを buffer にセーブする */ 

Void save_red_plane(char near *buffer) 

{ 

movedata(RED_PLANE f 0 t _DS t (unsigned) buffer, 80*400); 

} 

main() 

< 

save red_plane(buf )； 
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movmem 


機能 メモリブロックを指定の長さだけコピーします。 

形式 void moemem(void * src t void * dest, unsigned length ) : 

ブロトタイブ mem.h 


解脱 movmem は， length バイトのブロックを，分 r から dest へコ ピーします 0 

2 つのブロックがオーバーラップしている場合は，正しくコピーされるよう 
にコピーの方向が選ばれます。 

戻り値 ありません。 

W 連項目 memcpy. memmove, movedata 
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nosound 


機能 

形式 

プロトタイプ 

解脱 

戻り値 
閣連項目 


288 


PC .9801 :ダミー関数。 

IBM PC :スピーカを止めます。 

void nosoud(void) ; 

dos.h 

PC -9801 では， nosound は何の動作もしないダミー関数として定義されて 
います。 

IBM PC では， nosound は， sound の呼ひ•出しによって鳴っているス ピー 
力を止めます。 

ありません。 

delay , sound (IBM PC ) 
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一 open 


機能 ファイルを読み出しまたは害き込み用にオーブンします。 

形式 # include く fcntl . h 〉 

int open (const char * filename ，int ojlags ) •• 

プロトタイプ io.h 


解説 open filename に指定された ファ イルをオーブンし， ojlags の値にした 

がって読み出し，搿き込み，あるいは両用として準備を行ないます。 ファ 
イルは，グローバル変数/) node に指定されているモードでオーブンされ 
ます。 

oflags の値は ， DOS 2 .ズ の下では，0 RDONLY , O WRONLY , 0 —RDWR 
のいずれかに限定されます。 D 0 S 3 .ズ では，さらに以下の値を指定するこ 
とができます。 


0 NOINHERIT 

0 DENYALL 

ODENYWRITE 
0 —DENYREAD 
0 DENYNONE 


そのファイルを子ブロセスに引き継がないときに指 
定する。 

現在の ハン ドルだけがそのファイルにアクセスでき 
る。 

そのファイルに対する読み出し用オーブンのみを許 
す。 

そのファイルに対する搿き込み用オーブンのみを許 
す。 

その ファ イルに対する他のシェアドオーブンを許す。 


これらの0_•••シンボリック定数は fcntl . h の中で定義されています。 

DOS 3•ズの下では，1つの- open に対して ， O DENY ズズズ値のうち，1つだ 
けが指定できます。これらのファイルシェアリング属性は，ファイルの口 
ック機能に加えて用意されています。同時にオーブンできるファイル数の 
上限は，システムのコンフイギュレーシヨンハ◊ラメータ （ CONFIG . SYS フ 
アイル中の FILES の値）になっています。 
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戻り値 


成功すると， _ open は負でない整数（ファイルハンドル）を返します。フ 
ァイル中の現在位置を示すファイルボインタは，ファイルの先頭にセット 
されます。エラーの場合は-1を返し， errm > に次のいずれかの値をセット 
します。 

ENOENT ハ。 ス名またはファイル名が見つからなかった 
EMFILE オーブンされているファイルが多すぎる 

E ACCESS アクセスが否定されている 
EINVACC アクセスコードが正しくない 

可撤性 open は MS - DOS に特有の関数です。 

W 連項目 open , read , sopen 
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機能 


ファイルを読み出しまたは奔き込み用にオーブンします。 


形式 # include < fcntl . h > 

# include < sys ¥ stat . h > 

int open (const char * path , int access [, unsigned mode ]) : 
プロトタイプ io.h 

解脱 open は， path に指定された ファ イルをオーブンし， access の値にしたがっ 

て，読み出し，搿き込み，あるいは両用として準備を行ないます。 
accew に指定する値は，次に示す2つのリストのフラグをビットごとに OR 
することによって作られます。リスト1からは1つのフラグしか選べません。 
リスト2からは，複数のフラグを組み合わせることができます。 

リスト1:読み出し/害き込みフラグ 

0 RDONLY 読み出し挣用としてオーブン 
0_ WR 0 NLY 瘠き込み#用としてオーブン 
O RDWR 1充み出しおよび害き込み用としてオーブン 

リスト2:他のアクセスフラグ 

0 _NDELAY 使用されません。 UNIX とのコンハ•チビリティを図る 

ためのものです。 

OAPPEND これがセットされていると，ファイルポインタはまず 

ファイルの終わりに位置づけられます。 

O CREAT 指定のファイルがすでに存在していれば，このフラグ 

は意味を持ちません。存在していなければ，ファイル 
は新規作成され， mode のビットが chmod の場合と同 
様にして，域性ビットにセットされます。 

0 TRUNC ファイルが存在している場合は，その長さは0に削られ 
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ます。ファイル属性はそのままで変化しません。 

O EXCL 使用されません。 UNIX とのコンパチビリティを図る 

ためのものです。 

OBINARY このフラグは，明示的にバイナリモードでファイルを 

オーブンすることを示すのに使用されます。 

0 TEXT このフラグは，明示的にテキストモードでファイルを 

オーブンすることを示すのに使用されます。 

これらのシンボリック定数は， fcntl . h の中で定義されています。 
0 _BINARY も 0 _TEXT も与えられていない場合は，ファイルは，グロー 
バル変数_尸 morfe にセットされている変換モードでオーブンされます。 
特定のモードでファイルを新たに作成するには，そのモード値を 
に代入しておくか， 0 _CREAT および 0 _TRUNC と要求するモードの 
OR をとったものを open の引数 access と して与える必要があります。た 
とえば次の呼び出しは， 

openCxmp - , O^CREAT 1 0__TRUNC \ 0_BIHARY, S 一 IREAD> 

ファイル XMP を，バイナリモードで読み出し専用で作成します。 XMP が 
すでに存在している場合は，ファイルサイズを0バイトにします。 

0 CREAT フラグが mo みを作るのに使われると，オブションの引数 per - 
miss を次に示すシンボリック定数から作ることになります。 


mode の値 

アクセス許可 

SJWRITE 

瘠き込み可 

SJREAD 

読み出し可 

S IREAD | 

SJWRITE 說み害き可 
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戻り値 


成功すると， open は負でない整数（ファイルハンドル）を返します。ファ 
イルの現在位置を示すファイルポインタは，フアイルの先頭に位置づけら 
れます。エラーの場合は-1を返し， errm > に次のいずれかの値をセットし 
ます。 

ENOENT パス名またはファイル名が見つからなかった 
EMFILE オーブンされているファイルが多すぎる 

EACCESS アクセスが拒否された 
EINVACC アクセスコードが正しくない 

可搬性 open は UNIX システムで使用可能です。 UNIX バージョン7では，0_型の 

ニーモニツクは定義されていません。 UNIX システム III は， 0 _BINARY 
を除くすべての0_型ニーモニックを使用しています。 

閫連項目 chmod , chsize , close , creat , creatnew , creattemp , dup , dup 2, 

fdopen , filelength , fopen ， freopen , getftime , lock , open , 
read , sopen , write 
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outport 


機能 

形式 

プロトタイプ 

解脱 

戻り偭 
可搬性 
間連項目 
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ハードウヱアポートに1ヮード出力します。 

void outport (mt portid,\nt value ) : 
dos.h 

outport は，に指定された出カボートへ va / we に与えられたワード 
を出力します。 

ありません。 

outport は 80 x 86 ファミリィに特有の関数です。 

inport , inportb , outportb 
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outportb 


機能 

形式 

プロトタイプ 

解脱 


戻り値 

可撤性 
閫連項目 


ハードウェアボートに1バイト出力します。 


林 include < dos . h > 

void outportb (int portid 、 unsigned char value ), 


dos.h 


outportb は， portid に 指定された出カポートへ， va/we に指定された八イト 
を出力するマクロです。 

outportb は， dos . h がインクルードされている場合は，インラインコード 
に展開されるマクロとして扱われます。 

dos . h をインクルードしていない場合や，インクルードしていてもマクロ 
outportb を# undef している場合は，関数として扱われます。 

ありません。 

outportb は 80 x 86 ファミリィに特有の関数です。 

inport , inportb , outport 
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parsfnm 


機能 

ファイル名を解析します。 


形式 

# include < dos . h > 

char 木 parsfnm (const char * cmdline , struct fcb * fcb % ii 

it opt ) : 


プロトタイプ dos.h 

解脱 parsfnm は， cmdline が指す文字列を解析してファイル名を取りだします。 

cmdline は， 通常はコマンドラインです。ファイル名は FCB の中に，ドラ 

イブ，ファイル名，および抗張子として KS されます。/こ6が FCB を指し 
ています。 

引数吻は， DOS の解析システムコール 0 x 29 で AL に与える値です。シス 
テムコール 0 x 29 における解析処理の詳細については， MS - DOS ブログラマ 
ーズリファレンスマニュアルを参照してください。 

戻り値 ファイル名の解析に成功した場合， parsfnm は，ファイル名の終わりの次 

のバイトを指すポインタを返します。エラーが起こった場合は〇を返しま 
す。 

可搬性 parsfnm は MS - DOS に特有の関数です„ 
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peek 


機能 指定されたメモリ位 K のワードを返します。 

形式 int peek (unsigned segment , unsigned offset ) : 


プロトタイプ dos.h 


解脱 peek は ， segment •• offset のメモリ位; £ にあるワードを返します 0 

peek は， dos.h をインクルードしている場合は，インラインコードに展開 
されるマクロとして扱われ， dos.h をインクルードしていない（あるいはイ 
ンクルードしていても， #undefpeek としている）場合は，関数として扱 
われます。 

戻り値 peek は ， segment : offset のメモリ位 M にス トアされているワードを返し 

ます。 

可搬性 peek は 80 x 86 アーキテクチャに特有の関数です。 

W 連項目 harderr , peekb , poke 
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peekb 

機能 指定されたメモリ位置のバイトを返します。 

形式 # include < dos . h > 

char peekb (unsigned segment ，unsigned offset ) : 

プロトタイプ dos.h 

解脱 peekb は ， segment •• o / fsef のメモ”位 M にあるバイ トを返します。 

peekb は， dos . h をインクルードしている場合は，インラインコードに展開 
されるマクロとして扱われ， dos . h をインクルードしていない（あるいはイ 
ンクルードしていても ， #undef peekb としている）場合は，関数として扱 
われます。 

戻り値 peekb は ， segment : 〇ガ如のメモリ位3¢にストアされているバイトを返し 

ます。 

可撤性 peekb は 80 x 86 アーキテクチャに特有の関数です。 

関連項目 peek.pokeb 
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perror 

機能 

形式 

プロトタイプ 

解脱 


戻り値 
可撤性 
関連項目 


システムエラーメッセージをプリントします。 
void perror (const char * s ). 


stdio.h 


perror は，現在のブログラム内のシステムコールで起きた一番新しいエラ 
一を示すメッセージを，ストリーム stderr (通常は コン ソール）に出力しま 

す。 

まず引数 J をブリントし • その後にコロン， errno の現在の値に対！^する 
メッセージを絞け，最後に改行を出力します。慣例にしたがえば，引数ぶに 
はブログラムの名前を指定することになります。 

エラーメッセージ文字列の配列は， 8 以我 err/wf を通じてアクセスされま 
す。 errno を，エラー番号に対応する文字列を見つけ出すための添字とし 
て使うことができます。文字列には改行文字は含まれていません。 
sys nerr (±,配列内のメッセージの数を示しています0 

errno , sys errlist , 聊; terr の詳細については，第1章の「グロ - ハル 

変数」 を参照してください。 

ありません。 

perror は UNIX システムで使用でき， ANSI C と互換性があります0 

clearerr, eof，strerror, strerror 
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poke 

機能 指定のメモリ位置に整数値を格納します。 

形式 void poke (unsigned segment , unsigned offset , int value ) \ 

ブロトタイプ dos.h 

解脱 poke は ， segment : offset のメモリ位 S に，整数値 value を格納します。 

poke は， dos.h をインクルードしている場合には，インラインコードに展 
開されるマクロとして扱われます。 dos.h がインクルードされていない（あ 
るいはインクルードされていても， # undefpoke としている）場合は，マ 
クロではなく関数として扱われます。 

戻り偭 ありません。 

可搬性 poke は 80 x 86 フアミリィに特有の関数です。 

間連項目 harderr ， peek , pokeb 


300 


第 2* Turbo C ライブラリ 


pokeb 


捩能 指定のメモリ位：》にバイト値を格納します。 

形式 # include く dos . h > 

void pokeb (unsigned segment , unsigned offset 、 char value ). 


プロトタイプ dos.h 


解脱 pokeb は ， segment : offset のメモリ位 S に，パイト値 value を 格納しま 

す。 

pokeb は， dos . h をインクルードしている場合には，インラインコードに展 
開されるマクロとして扱われます。 dos . h がインクルードされていない（あ 
るいはインクルードされていても， # undefpokeb としている）場合は，マ 
クロではなく関数として扱われます。 

戻り価 ありません。 

可搬性 pokeb は 80 x 86 ファミリィに特有の関数です。 

関連項目 peekb , poke 
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poly 一 

機能 

形式 

プロトタイプ 

解脱 


戻り値 
可搬性 


多項式の計算 
# include < math . h > 

double poly (double ズ ， int degree ，double coeffs []) : 
math.h 

poly は，係数 coeffs [\] . coeffs [ degree ], 次敗 degree 

多項式のズにおける値を計算します。たとえば， degree = 4の場合， 生成さ 
れる多項式は次のようになります。 

coeffs [4] x 4 + coeffs [3] x 3 + coeffs [2] x 2 
+ coeffs[\]x -f coeffs [ Q ] 


poly は，ズにおける多項式の値を返します。 
poly は UNIX システムで使用できます。 


302 


第2章 Turbo C ライブラリ 


pow 


機能 

ズの夕乗を計箨します。 

形式 

# include く math . h > 

double pow (double x t double y ) 

プロトタイプ 

math.h 

解脱 

pow は，パを計算します。 

戻り値 

pow 関数は，成功した場合，計算結果を返します。 

弓1数の値によっては，オーハ•ーフローが起きたり，計算できないことがあ 
ります。計麻結果がオー八ーフローになる場合， pow は HUGE_VAL を返 
します。大きさが非常に大きい結果の場合は errno に次の侦:をセットしま 

す。 


ERANGE 値 W エラー 


引数ズが〇以下で，かつ y が整数でなかった場合には， errno は次の値にセ 

ットされます。 


EDOM 定莪域エラー 


引数ズと夕がともに0であった場合には， pow は1を返します。 

pow のエラー処理は， matherr 関数を使って変更することができます。 

可搬性 

pow は UNIX システムで使用でき， ANSI C と互換性があります。 

M 連項目 

exp , powlO , sqrt 
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powlO 

機能 10 の P 乗を計舞:します。 

形式 # include く math . h 〉 

double powl 0 (int p ) : 

プロトタイプ math.h 
解脱 powlO は，1〇0を計算します。 

戻り値 powlO 関数は，成功した場合は計算結果 1(^ を返します。 

結果は内部では long double で計算されます。このため有効な引数であっ 
ても，アンダーフロー またはオーバーフローが起きることがあります。 

可撤性 powlO は UNIX システムで使用できます。 

間連項目 exp , pow 
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printf 

機能 袢式つき出力を w 也⑽に冉き出します。 

形式 int printf (const char * format [, argument ，•••]): 

ブロトタイプ stdio.h 

解脱 printf は ， format \ こ よって指される辨式文字列中の} 4 f 式指定を， format の 

後に絞く各引数に適用し，害式化されたデータをがぬ以に出力します。冉 
式指定は，後に絞く引数と同じ数だけなければなりません。 

香式文字列： 

拜式文字列は printf 関数に含まれていますが，これは関数がどのように 
引数を変換，科式化，ブリントするかを指定するものです。#式文字列 
に対して充分な数の引数が必要です。引数がたりない場合は，結果は予 
SiJ できないものになります。引数が多すぎる場合は，単に無视されるだ 
けです。 

冉式文字列には，2神:類のオブジェクトが含まれています。通常の文字と 
変換指定です。 

■通常の文字は単に出カストリームに1文字ずつ送られます。 

■変換指定は，引数リストから引数を取り出し，袢式化を行ないます。 
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変換指定： 

printf の宵式文字列は次のような形式をもっています。 

Z 【フラグ】[印字幅】【•精度】 [ F : N | h | l | L ] 型 

各変換指定は％で始まります。％に統いて，以下に示すものが，この順 
で現われます。 


■オブションのフラグ文字の並ぴ 
■オプションの印字幅指定子 
■オプションの 稍 度指定子 
■オブションの入カサイズ修飾子 
■変換指定文字 

害式文字列のオプションの要素： 

龄式文字列におけるオプションの文字，指定子，修飾子によって行われ 
る出力の 害 式化の概要を示します。 


文字/指定子 何を制御するのか，または何を指定するのか 


フラグ 左詰めか右詰めか，数値の符号，小数点，後に絞くゼロ， 

8進/16進のブレフイクス 

印字蝠 印字する最小文字数，余白をゼロ/空白どちらで埋めるか 

精度 印字する煅大文字数：整数の場合は印字する煅小桁数 

サイズ 引数のデフォルトサイズを変更する 

(N = near ポインタ ， F = far ポインタ ， h = short int ， 
l = long , L=long double ) 
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printf の変換指定文字： 

次の表には， printf の変換指定文字，許される引数の型，の害式が示さ 
れています。 

表中の情報は，害式指定には，フラグ文字，印字幅指定， W 度指定，人 
カサイズ指定が含まれていないと仮定した場合に基づいています。オブ 
ションの文字および指定子がどのような影響を与えるかについては，こ 
の後の表を参照してください。 


型指定文字 

入力引数 

出力の香式 

数値 

d 

整数 

符号つき10進整数 

• 

1 

整数 

符号つき10進览数 

〇 

整数 

符号なし8進整数 

U 

整数 

符号なし10進整数 

X 

整数 

符号なし16進整数 ( a , b , c t d y ej を使用） 

X 

格数 

符号なし16進整数（ん糸 C . D . F ， を使 

用） 

f 

浮動小数点数 

符号つきの \r]dddd.dddd 形式の値 

e 

浮動小数点数 

符号つき の [/] d . Mdde [ + / -] ddd 形式 

の値 

K 

浮動小数点数 

符号つきの e または/形式の値，どちら 
になるかは与えられた値と精度によって 
決まる。後に絞くゼロおよび小数点は必 

要な場合にだけ印字される。 

E 

浮動小数点 

e と同じ，指数部を示す記号はどにな 



る。 

G 

浮動小数点 

ぎと同じ， e 形式が使用されるときは指 

数部を示す記号は £になる。 
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文字 

C 

文字 

一個の文字。 

8 

文字列ポインタ 

ヌル文字に出会うか，精度に達するま 

で文字をブリントする。 

% 

なし 

文字％がブリントされる。 

ポインタ 

n 

整数ポインタ 

これまで赛かれた文字の数を（入力引 

数によって指された場所に）格納する 

p 

ポインタ 

入力引数をボインタとして印字する。 

far ボインタは XXXX : YYYY ， 

near ポインタは YYYY (オフセット 

だけ）と印字される。 
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慣例： 


これらの指定子のいくつかに関しては次に示すような慣例があります。 


文字 憤例 


e,E 引数は [-] ゴ•ゴゴム .e[ + /-] ゴゴゴ形式に変換される。 

• 小数点の前には数字が1桁だけ S かれる 
•小数点の後には「«度 j 桁の数字が置かれる 
• 指数部は常に3桁 

f 引数は10進で [-] ゴゴゴ A/. ••形式に変換され，小数点の後の桁数 

は精度と等しくなる （ W 度が0でないとき）。 
g，G 引数は e ， EJ のいずれかの形式で印字される。 W 度が有効数字 

の桁数を決める。後続の0は省略され，小数点は必要なときにの 
みつけられる。 

変換指定文定がぎの場合は， e または/形式で印字される 。 G 
の場合は£：形式で印字される。変換の結果得られる指数部が次 
の場合には e 形式が使われる0 

(a) 精度より大きい 

( b ) —4より小さい 

x，X ズ変換では，文字 a,6,c,rf,e/ が出力中に現われ， AT 変換では 
ん忍,が現われる。 


注窓：浮動小数点数の無限値は， +INF あるいは一 INF としてブリント 
されます。また， IEEE の非数 （ Not-a — Number ) は， + NAN あるい 
は一 NAN としてブリントされます。 
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フラグ文字： 

フラグとして使用される文字は，•，十，#,空白です。これらは組み合わ 
せて指定できます。 


フラグ 何を指定するか 


一 結果を左詰めで印字する。つまり右側に空白を埋め込む。この指 

定がないと結果は右詰めで印字される。つまり，左側に ゼロ また 
は空白を埋め込む。 

+ 符号つき変換の結果は，常に十か一の符号がつけられてブリント 

される。 

空白 値が負でない場合は，正符号をつけずに空白で始まる。負の場合 

は負符号で始まる。 

# 引数が交袢形式を用いて変換されることを指定します。次の表を 

参照。 


注意： 十と空白が両方指定されている場合は十が優先します。 

交替形式： 

#が変換文字とともに使用された場合は，変換される引数に対して次のよ 
うな効果をもちます。 


変換文字 #がどんな影響を与えるか 


c，s,d，i，u 影酈なし 

〇 0でない引数の場合，その前に0がつけられる。 

x，X Ox (または OX) が引数の前につく。 
e,E,f 出力には，その後に数字がなくても常に小数点が含まれる。 
通常は，後に数字があるときにのみ小数点が置かれる。 
g，G の場合と同じ。ただし最後のゼロは省略される。 
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印字幅指定子： 

印字幅指定子は，出力のための最小のフィールド幅をセットします。 
印字幅の指定する方法は2通りあります。数字列を使って直接的に指定す 
るものと，アスタリスク （*) を使って間接的に指定するものがありま 
す。印字幅指定子としてアスタリスクを使う場合，実際に出力される引 
数の前に，印字幅指定子を含む引数 （ int 型でなければならない）が指定 
されていなければなりません。 

印字幅が小さくても， フィールドが 削られることはありません。変換の 
結果が フィールド 幅より 広い 場合は， フィールドは 単にひろげられ，変 
換された結果が人ります。 


印字幅指定子 

出力幅はどのようになるか 

n 

少なくとも”文字印字される。出力値が/»文字より少な 
いときは空白で埋められる（•フラグがある場合は右側， 

ない場合は左側)。 

On 

少なくとも n 文字印字される。出力値が n 文字より少な 
いときは ゼロで 埋められる（-フラグがある場合は右側， 

ない場合は左側)。 

木 

引数リストは印字幅指定子を含む。印字幅指定子は 押 式 
化される実引数の前に S かなくてはならない。 


精度指定子： 

精度指定子は常にピリオド （.） で始まり，印字幅指定子とは区別されま 
す。印字幅の場合と同様，精度も，数字列を使って直接，あるいはアス 
タリスク （*) を使って間接に指定することができます。精度指定子に 
アスタリスクを使う場合，実際に出力される引数の前に， W 度指定子を 
含む引数 （ int 型でなければならない）を指定しなければなりません。 
アスタリスクを，印字幅指定子と精度指定子の両方に指定した場合は， 
実際に変換される引数の前に2つの引数が S かれることになります。 
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精度指定子 出力精度はどのよ 


指定なし デフォルトの精度 

d t i t o t u t x t X 形式 1 

e t EJ 形式 6 

ぎ, G 形式 有効数字すべて 

s 形式 ヌル文字までブリントする 

c 形式 影響を与えない 

.0 ゴ乂 Aw〆 形式に対しては精度はデフォルト値にセット 

される。 e t EJ 形式に対しては小数点は出力されない。 

• n n 文字あるいは； j 桁が印字される。出力値が/ 2 文字以上 

の場合は，出力は（変換指定文字によって）削られたり 
丸められたりすることがある。 

* 引数リストは W 度指定子を含んでいる。稍度指定子は弊 

式化される実引数の前に》かなくてはならない。 


注意：明示的に M 度0が指定され， そのフィ ー ルドの 冉式指定が整数形式 
(ゴ， /， o , w , ズ）で，なおかつ印字される値が〇 の 場合には， そのフィールド 
には数字はまったく出力されません（つまり そのフィールドは 空白にな 
ります)。 


変換文字 精度指定子はどのような影響を与えるか 


d ， i ， o ， u ， x，X ./I は，最低 n 桁が印字されることを指定する。入力引数が 

”桁より少ない場合は，出力値は左側がゼロで埋められる。 
入力引数が/2桁より大きくても出力値は削られない。 
e ， E，f ぶは， 小数点の後に”文字印字されることを指定する。 最 

後の桁は丸められる。 

g，G •/? は，最大/2桁の有効数字が印字されることを指定する。 

c ⑺は，出力に関して何の影響も与えない。 

力は，”文字以上の文字が印字されないことを指定する。 
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入カサイズ修飾子： 

入カ サイズ修飾子の文字 [ F 、 N ， h ， l ， L ) 次に 示す 人力 引数のサイズを 

与えます。 

尸= far * ポインタ / = long 
N = near ポインタ L = long double 
h = short int 

人カサイズ修飾子び，人/, L ) は，対応する入力引数のデータ型を... 
printf 関数がどのように解釈するかに影®を与えます。 F と AMi , ボイ 
ンタ…の引数に対してのみ使用することができます。 A , /お 
よびしは，数値（整数と浮動小数点数）の入力引数に対してのみ適用で 
きます。 

F と AMi ともに，人力引数を再解釈するためのものです。通常は％/>，％ 
s % n 変換に対応する引数は，使用中のメモリモデルのデフオルトサイ 
ズのポインタです。 F は「入力引数を far ポインタとして解釈する 」， W 
は「入力引数を near ポインタとして解釈する」という意味です 0 
ケ/およびんはともに，入力数値データ引数のデフォルトのサイズを変 
更するためのものです。/とムは整数（め>>,ズ,幻と浮動小数点数（ど, 
ふ G ) の各形式に対して適用できるのに対し， A は！ S 数形式にしか適 
用できません。 h , /および L は， 文字の形式や， ポインタの p ， n 形 
式には影響を与えません。 


入カサイズ修飾子 引数がどう解釈されるか 

F 引数は far ポインタとして解釈される。 

N 引数は near ポインタとして解釈される。 W はヒュー 

ジモデルでは，どんな変換とも組み合わせて使うこと 
はできません。 

h d ， i ， o ， u ， x ， X では，引数は short int として解釈される。 

1 d t i t o t u t x t X では，引数は long int と解釈される。 

e t EJ , g t G では，引数は double と解釈される。 

L e t EJ t g t G では，引数は long double と解釈される。 
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可撤性 

関連項目 


は出力したバイト数を返します。エラーの場合は EOF を返し 

は UNIX システムで使用でき ， ANSI C と互換性があります。 
定義されています。 

:， ecvt , fprintf , fread , fscanf , putc , puts , putw ， 
sprintf , vprintf , vsprintf 


例 


/include <8tdio.h> 
Idefine I 555 
Idefine R 5-5 


main() { 

int i t i. k f 1; 
char buf(7 J; 
char *prefix _ buf; 
char tp[20]s 



printf("prefix 6d 6o 8x 

8trcpy(prefix t ■!■); 
for (i - 0; i < 2 5 i++) { 

for (j - 0; j < 25 j++> 
for (k - 0; k < 2; k++) 

for (1- 0;1 < 2; 1++) { 

if (i ■■ 0> 8trcat(prefix f 
if (j — 0) 8trcat(prefix f 
if (k ■■ 0> 8trcat(prefix. 
if ( 1 — 0 ) 8trcat(prefix f 
printf(*Z58 1*, prefix )5 
strcpy(tp f prefix); 
strcat(tp f Md Os 
printf(tp f I )； 
strcpy(tp f ••); 
strcpy(tp f prefix); 
8trcat(tp 9 B 6o |_); 
printf(tp # I); 

8trcpy(tp # •_); 
strcpy(tp f prefix); 
strcat(tp f *8x |*)5 
printf(tp t I); 

8 trcpy(tp # 
strcpy(tp f prefix); 
strcat(tp f •10.2e |*)s 
printf(tp, R)s 
8 trcpy(tp f prefix) 5 
8 trcat(tp f .lOdf |*)5 
printf(tp # R); 
printf(• ¥n*); 
8 trcpy(prefix f "I*); 


10 . 2 e 



• 0 _>; 


10 . 2 f¥n 
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6 o 8 z 

0z22b 
0x22b 
22b 
22b 
0x22b 
0x22b 
22b 
22b 

0x00022b 
0x22b 
0000022b 
22b 
0x00022b 
0x22b 
0000022b 
22b 


10-2e 
|+5.50e+0 
|+5.50e+0 
|+5-50e+0 
!+5.50e+0 









putc 

捩能 ストリームに1文字を出力します。 

形式 # include く stdio . h 〉 

int putc(int c , FILE * stream ) : 

プロトタイプ stdio.h 

解脱 putc は，文字 c をが/扣 /w に指定されたストリームへ出力するマクロです。 

戻り値 成功した場合, putc は出力した文字 c を返します。エラーの場合は EOF を 

返します。 

可撤性 putc は UNIX システムで使用でき， ANSIC と互換性があります。 K&R 

でも定莪されています。 

閩連項目 fprintf , fputc , fputch ， getc , getchar , printf , putch，putchar 
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putch 


機能 

形式 

プロトタイプ 

解脱 

戻り偭 

可撤性 

閭連項目 


画面に1文字を出力します。 
int putch Unt c ) : 

como.h 

putch は，文字 C をカレントテキストウインドウに出力します。 putch は, 
コンソールへの直接出力を行なうテキストモード関数です。 putch は，改行 
文字 （¥ n ) を CR / LF ベアに変換しません。 


成功した場合， putch は印字した文字 c を返します。エラーの場合には 
EOF を返します。 

putch は PC -9801 シリーズ（または IBM PC とその互換機）でのみ動作し 
ます。 

cprinti t cputs ， getch ， getche ， putc，putchar 


318 


第 2 章 Turbo C ライブラリ 


putchar 

機能 stdout へ文字を出力します 0 

形式 # include < stdio . h > 

int putchar unt c ). 

プロトタイプ stdio.h 

解脱 putchar ( c ) li , putc(q 灯ぬ w /) と定義されたマクロです 0 

戻り値 成功した場合， putchar は文字(：を返します。エラーの場合には EOF を返 

します。 

可撤性 putchar は UNIX システムで使用でき， ANSI C と互換性があります。 K & 

R でも定我されています。 

関連項目 fputchar , getc , getchar , putc , putch , puts 
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putenv 

機能 現在の環境変数に文字列を追加します。 

形式 int putenv (const char * name ) : 

プロトタイプ stdlib.h 

解脱 putenv は，文字列を引数にとり，それを現在のブロセスの琛境に追 

加します。たとえば次のように呼び出します。 

putenv(•PATH-A:¥FOO*) ; 

putenv は，すでにある name を変更または削除するためにも使用できま 
す。削除するときは，その変数の値を空にします（たとえば” MYVAR = ” 
のように指定します)。 

putenv が変史するのは現在のブログラムの環境だけです。ブログラムが終 
了すれば元の環境が回復されます。 

戻り値 putenv は，成功した場合は0を返し，エラーの場合は-1を返します。 

可搬性 putenv は UNIX システムで使用できます。 

閱連項目 getenv 
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puts 


機能 

形式 

プロトタイプ 

解脱 

戻り価 

可搬性 
M 連項目 


s — t に 文字列を出力します。 
int puts (const char + s ) : 
stdio.h 

puts は，ヌル文字で終わる文字列 J を，標準出カストリームがゐこ出力 
し，最後に改行文字をつけます。 

puts は，成功した場合は負でない値を返し，エラーの場合は EOF を返しま 
す。 

puts は UNIX システムで使用でき ， ANSI C と互換性があります。 

cputs , fputs , gets , printf , putchar 
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putw 


機能 ストリームに整数を出力します。 

形式 # include < stdio . h > 

int putw(int w t FILt * stream ) \ 

プロトタイプ stdio.h 

解脱 putw は，整数 w を出カストリームが ream に出力します。 putw は， ファ 

イルの中での特別なアラインメントは想定しておらず，また行ないません0 

戻り値 putw は，成功した場合は整数 w を返します。エラーの場合はは EOF を返 

します。 

EOF は putw が正常な値として返す按数なので， putw のエラーを検出す 
るには ferror を使用するべきです 0 

可搬性 putw は UNIX システムで使用できます。 

関連項目 getw , printf 
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qsort 


機能 クイックソートアルゴリズムを用いてソートを行ないます。 

形式 void qsoruvoid * base ， size t nelem t size t width ， 

int ( * fcmp ) (const void *, const void *)): 

プロトタイプ stdlib.h 

解脱 qsort は，クイックソートアルゴリズムの1つ“ 3つのメディアン”を実現し 

たものです。 qsort は， /cmp が指すユーザ定我の比較関数を繰り返し呼び 
出して，テーブル中の項目をソートします 0 

■ ftaye は， ソート されるべきテーブルの ベース （つまり〇番目の要素）を 
指しています。 

■ nelem はテーブル中の項目の数です。 

■ H 7 V / 认はテーブル中の各項目の大きさ（単位：バイト）です 


比較関数* fcmp ( i , 2つの引数 e / em / と elem 2 をとります。2つの引数はテ 
ーブル中の項目へのポインタです。比較関数はこの2つの項目 （* eleml ,* 
elem 2) を比較し，その比較結果を整数で返します。 


比較結果 


fcmp の戻り値 


* eleml < * eleml 負の整数 

ホ eleml == * elem 2 〇 

* eleml > * elem 2 正の祭数 


不等号くは，左側の項目が，最終的にソートされた並びにおいて，右側の項 
目より前に来るべきであることを意味します。同様に，> は左側の項目が， 
最終的にソートされた並びにおいて，右側の項目より後に来るべきである 
ことを意味します。 
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戻り偭 
可搬性 
関連項目 

例 


324 


ありません。 


qsort は UNIX システムで使用でき ， ANSI C と互換性があります。 

bsearch，(search 


#include <8tdio.h> 

#include <8tdlib.h> 

#include <8tring.h> 

char li8t[5](4) - { _caf, *car* f -cab*, ， cap_, *can* }; 

main() 

( 

int vs 

qsort(&li8t f 5 f sizeof(li8t[10]) f strcmp); 
for (x - 0; x < 5; x++> 
printfCZ8¥n- f li«t[x]); 


プログラム出力 

cab 

can 

cap 
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raise 


機能 実行中のブログラムにソフトウェアシグナルを送ります。 

形式 # include く signal . h 〉 

int raise (int sig ) : 

プロトタイプ signal.h 

解脱 raise は， 5 な型のシグナルをブログラムに送ります。 Wg によって指定され 

るシグナル型に対するシグナルハンドラがインストールされている場合は, 
そのハンドラが実行されます。ハンドラがインストールされていない場合 
は，そのシグナル型に対するデフォルトの処理が行なわれます。 

シグナル型は， signal . h の中で次のように定義されています。 



SIGABRT 異常終了 （*) 

SIGFPE 正しくない浮動小数点演算 

SIGILL 不当な命令 （#) 

SIGINT コントロールブレーク割り込み 

SIGSEGV 主記 1* に対する正しくないアクセス （#) 

SIGTERM ブログラム終了の要求 （*) 


アスタリスタ*がついているシグナル型は，通常の操作では DOS や 
Turbo C によって生成されることはありません。それらは ra i se で生成さ 
れるものです。シャープ#がついているシグナルは，8088や8086プロセッサ 
では非同期的に生成することはできませんが，他のプロセッサでは生成さ 
れることがあります（詳しくは signal の解説を参照してください)。 

戻り値 成功した場合は0，そうでない場合は0以外の値を返します。 
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可撤性 raise は UNIX システムで使用でき ， ANSI C と互換性があります。 


関連項目 abort，signal 


例 # include <8ignal.h> 

main() 

{ 

int a t d, c ； 

a _ 10 ; 
b _ 0; 
if (b -■ 0) 

rai 8 e(SIGPPE)j /* ゼロ離 H [ エラーを取り離く */ 

C - a / b; 
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rand 


機能 

形式 

プロトタイプ 

解脱 

戻り値 
可撤性 
M 連項目 

例 


乱数発生ルーチンです。 
mt rand ( void ) : 


stdlib.h 


rand は，周期 2 32 の乗法合同法を用いて乱数を発生し，呼び出されるたび 
に〇〜 RAND _ MAX の間の疑似乱数を返します。シンボリ ッ ク定数 RAND 
MAX は stdlib . h の中で定我されており，値は215士1です。 

rand は，生成した疑似乱数値を返します。 

rand は UNIX システムで使用でき ， ANSI C と互換性があります。 

random , randomize , srand 


/include <time.h> 

#include <8tdio.h> 

#include <stdlib.h> 

main(> /* 0-32767 の範囲の 5 つの乱败を表示する */ 

( 

int i; 

srand (time (NULL) Z 37); /* ランダムな值から始める */ 

for (i_0; i<5; i++) 

printf(_Zd¥n' rand()) 5 
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randbrd 


機能 ランダムなブロック読み出しを行ないます。 

形式 # include く dos . h > 

int randbrd (struct fcb * fcb , int rent ) : 


プロトタイプ dos.h 


解脱 randbrd は， / c わが指すオーブンされているファイルコントロールブロッ 

ク （ FCB ) を使って， rc / if 個のレコードを読み込みます。レコードは， 現 
在のディスク転送アドレス （ DTA ) のメモリに， FCB のランダムレコード 
フィールドで指定されたディスクレコードから统まれます。これは DOS 
システムコール 0 x 27 を呼び出すことによって行なわれます。 

実際に统み出された レコー ドの数は， FCB のランダム レコードフィールド 
を调ベることによって得ることができます。ランダム レコードフィールド 
は，実際に說み出された レコード 数だけ増加します。 

戻り値 randbrd の結果によって次に示す値が返されます。 

0 すべての レコ ードが読み込まれました。 

1 EOF に達し，最後のレコードは完全に読み込まれました。 

2 読み込むレコードが OxFFFF を越えます（可能な最大数の レコー 
ドが說まれました）。 

3 EOF に達し，©後のレコードは不完全でした。 

可搬性 randbrd は MS - DOS に特有な関数です。 

M 連項目 getdta ， randbwr , setdta 
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randbwr 


機能 ランダムなブロック齊き込みを行ないます。 

形式 # include < dos . h > 

mt randbwr (struct fcb 本 fcb t int rent ) \ 

ブロトタイプ dos.h 

解脱 randbwr は， / e 6 が指すオーブンされているファイルコント ロールブロッ 

ク （ FCB ) を使つて，び/^個のレコードを叩き込みます。レコ-ドは，現 
在のディスク転送アドレス （ DTA ) のメモリから’ FCB のランダム レコー 
ドフィールドで指定されたディスクレコードへ冉き込まれます。これは， 
DOS システムコール 0 x 28 を呼び出すことによって行なわれます。 rcn t が Q 
の場合，ファイルの長さは，ランダムレコードフィールドが示して いる 値 
にセットされます。 

実際に W き込まれた レコードの 数は ， FCB のランダムレコードフィールド 

を調べることによって得ることができます。ランダムレコードフフィール 

ドは，実際に統み出された，あるいは辨き込まれた レコード 数 だけ 增加し 
ます。 

戻り 1 置 randbwr の結果によって次に示す値が返されます。 

0 すべてのレコードが害き込まれました。 

1 レコードを涔き込むだけのディスク領域がありません（レコードは 
いっさい* き込まれません）。 

2 冉き込もうとするレコードが OxFFFF を越えます（可能な最大数 
の レコー ドが宵き込まれました）。 

可搬性 randbwr は MS - DOS に特有な関数です。 

関連項目 randbrd 
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random 


機能 

乱数発生ルーチンです0 

形式 

# include く stdlib . h 〉 


int random (int num ) : 


プロトタイプ stdlib.h 

解脱 random は， 0 と （ nwm - l ) の間の乱数を返します 0 random (/ m 爪）は，マク 

口として （randO % ( m / m )) と定義されています。 num と返される乱数は 
どちらも整数です。 

戻り値 random は，0と （ nwm -1) の間の数値を返します。 

可撤性 これに対応する関数が Turbo Pascal にもあります。 

閣連項目 rand , randomize , srand 


例 


#include <stdlib.h> 
/include <time.h> 


/* 〇〜 99 の糖■の&败を • ランダムな個败出力する */ 
main() 

{ 

int n; 

randomize(); 

/*1 〜 20 の範囲のランダムな值をとる */ 
n _ random(20) +1; 
while (n — > 0) 

printf (*2d • f random ( 100 ) )； 
printf( B ¥n - )； 
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randomize 


機能 

形式 

プロトタイプ 

解脱 

戻り値 

可撤性 

M 連項目 


乱数発生ルーチンを初期化します。 


# include く stdlib.h 〉 

# include <time.h> 
void randomize (void); 


stdlib.h 

randomize は，ランダムな値によって乱数発生ルーチンを初期化します。 
randomize は， へッ ダフアイル time.h でブロトタイブ宣言されている 
time 関数を呼び出すマクロなので，この関数を使う場合は， time.h をイン 
クルードするようにしてください。 

戻り値はありません。 

これに対応する関数が Turbo Pascal にもあります。 

rand , random , srand 
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機能 


フアイルから読み込みを行ないます。 


形式 

プロトタイプ 

解脱 


戻り値 


可撤性 

関連項目 

332 


int read(int handle ，void * buf ，unsigned len ) \ 



read は，に結びつけられているファイルから/例バイトを铣み込 
んで， 6 w / が指しているバッファに格納します。 read は， DOS システム 
コールを直接呼び出します。 

テキストモードでオーブンされたファイルに対しては， _read は復帰文字 
( OxOD ) を削除しません。 

handle は， creat , open , dup , dup 2 の呼び出しで得られたファイル ハン 
ドルです。 

デイスクファイルでは， —read は現在のファイルボインタの位置から統み 
込みを開始します。統み込みが終了したときに，ファイルポインタを統み 
込んだバイト数だけインクリメントします。デバイスの場合は，バイトは 
デバイスから直接読まれます。 

read で読み込めるバイト数は最大65534バイトです。65535 ( OxFFFF ) は 
-1 と同じであり，エラーを示すために使用されます。 

成功した場合， _read はバッファに格納されたバイト数を示す正の整数を 
返します。ファイルエンドを読み込んだ場合は0を返します。エラーの場合 
は-1を返し， errno に次のいずれかの値をセットします。 

EACCES アクセスが拒否された 
EBADF ファイル番号が正しくない 

_read は MS-DOS に特有の関数です。 

open , read , write 
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read 



機能 ファイルから統み込みを行ないます。 

形式 int read(int handle 、void * buf ，unsigned ten) \ 

プロトタイプ io.h 

解脱 read li , handle と結びつけられているファイルから / en バイト を|光み込ん 

で，加ゾが指しているバッファに格納します。 

テキストモードでオーブンされた ファ イルに対しては， read は復帰文字を 
削除し，ファイルエンドを読み込んだときには，それを知らせます。 
nandle は， creat ， open , dup ， dup 2 の呼び出しで得られたファイル ハン 
ドルです。 

デイスクファイルでは， read は，現在のファイルポインタの位置から読み 
込みを開始します。読み込みが終了したときに，ファイルポインタを読み 
込んだバイト数だけインクリメントします。デバイスの場合は，バイトは 
デバイスから直接読まれます。 

read で読み込めるハ•イト数は最大65534ハ•イトです。65535 ( OxFFFF ) は 
-1 と同じであり，エラーを示すために使用されます。 

反り値 成功した場合， read は，バッファに格納されたバイト数を示す正の整数を 

返します。ファイルがテキストモードでオーブンされている場合は ， read 
は復帰文字および CTR し Z 文字はカウントしません。 

ファイルエンドを読み込んだ場合は〇を返します。エラーの場合は-1を返 
し， errno に次のいずれかの値を セッ トします。 

EACCES アクセスが拒否された 

EBADF ファイル番号が正しくない 

可撤性 read は UNIX システムで使用できます。 

関連項目 open , read , write 
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realloc 


機能 

形式 

プロトタイプ 

解脱 


戻り値 

可搬性 

関連項目 

例 
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メモリの再割り当てを行ないます。 


# include く stdlib . h 〉 

void * realloc (void * block ，size t size ) : 


stdlib . h , alloc.h 

realloc は，すでに確保されているブロックを， size パイ トに縮小または拡 
張します。引数 block hi ， 以前の malloc , calloc , あるいは realloc の呼び 
出しで得られたメモリブロックを指すポインタです。 block がヌルボイン 
夕の場合には， realloc は malloc とまったく同じように機能します。 
realloc は，割り当て済みのブロックをのサイズをに調整し，必要であ 
ればブロックの内容を新しい領域に コピーし ます。 

realloc は，再割り当てされたブロックのアドレスを返します。これは，以 
前のブロックのアドレスとは異なる場合もあります。ブロックを再割り当 
てできなかった場合，あるいは5故==〇の場合には NULL を返します。 

realloc は UNIX システムで使用でき ， ANSI C と互換性があります。 

calloc ， farrealloc , free , malloc 
malloc を参照してください。 
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remove 


機能 

ファイルを削除します。 

形式 

林 include く stdio . h 〉 

int remove (const char 本 filename )； 

プロトタイプ 

stdio.h 

解脱 

remove は，に指定されたファイルを削除します 0 remove は，単 
に unlink の呼び出しに展開されるマクロです。 

戻り値 

成功した場合は0を返します。エラーの場合は-1を返し， errno に次のいず 
れかをセットします。 


ENOENT そのようなファイルあるいはディレクトリはない 

EACCES アクセスが拒否された 

可撤性 

remove は UNIX システムで使用でき ， ANSI C と互換性があります 0 

M 連項目 

unlink 
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rename 


機能 ファイル名を変更します。 

形式 int rename (const char 本 oldname , const char 本 newname ) : 

プロトタイプ stdio.h 

解脱 rename は，ファイルの名前を oldname から newname に変更します。 new - 

n 賊 e にドライブ名の指定がある場合は， oldname のものと同じでなけれ 
ばなりません。 

バス名の中のディレクトリは同じである必要はありません。したがって， 
rename によって，ファイルをあるディレクトリから別のディレクトリに 
移すこともできます。ワイルドカードは使えません。 

戻り価 成功した場合， rename は0を返します 0 エラーの場合は -1 を返し ， errno 

に次の値のいずれかをセットします。 

ENOENT そのようなファイルまたはディレクトリはない 

EACCES アクセスが拒否された 

ENOTSAM 同じデバイスではない 

可撤性 rename は ANSI C と互換性があります。 
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rewind 


機能 

形式 

プロトタイプ 

解脱 

戻り値 
可搬性 

関連項目 

例 


フアイルポインタをフアイルの先頭に移動します。 

# include く stdio.h 〉 

void rewind (FILE * stream) : 

stdio.h 

rewind (が/^爪）は ， fseek (价扣 m , OL , SEEK _ SET ) とほぼ同じです〇ただ 
し， rewind はファイル終了標識と エラー 標識の両方をクリアしますが， 
fseek はファイル終了標識のみをクリアします。 

更新用にオーブンされたファイルでは， rewind を呼び出した後は，入力 • 
出力どちらでも行なうことができます。 

ありません。 

rewind はすべての UNIX システムで使用でき， ANSI C と互換性があり 
ます。 

fopen ， fseek , ftell 
fseek を参照してください。 
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rmdir 


機能 ディレクトリを削除します0 

形式 int rmdir (const char * path ) : 

プロトタイプ dir.h 

解脱 rmdir は， path に指定されたディレクトリを削除します。 path が示すディ 

レクトリ名は， 

■空でなければなりません。 

■現在の作業ディレクトリであってはなりません 0 
■ルートディレクトリであってはなりません。 

戻り 値 rmdir は，ディレクトリを削除できた場合には0を返します。エラーの場合 

は-1を返し， errm > に次のいずれかをセットします。 

EACCESS アクセスが否定されている 

ENOENT パス名またはファイル名が見つからない 

閣連項目 chdir , getcurdir , getcwd , mkdir 
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機能 


符号なし整数値をビットごとに左へローテートします。 


形式 

ブロトタイプ 

解脱 

戻り値 
関連項目 

例 


unsigned rotl (unsigned value . int count ) : 


stdlib.h 


— rotl は，与えられた値 を count ビットだけ左へローテートします。 
ローテートされる値は unsigned です。 


rotl は，左へビットローテートした値を返します。 


lrotl 


# include <stdlib.h> 

main() 

{ 

printfCrotate OxABCD 4 bits left - Z04X¥n B f 
_rotl(OxABCD f 4)); 

printf('rotate OxABCD 4 bits right - Z04X¥n* t 
_rotr(OxABCD, 4)); 

printf(-rotate 0x555555551 bit left _ Z081X¥n' 
_lrotl(0x 55555555 L t 1)); 

printf("rotate OxAAAAAAAA 1 bit right - 2081X¥n* f 
_lrotr(OxAAAAAAAAL f 1)); 


ブログラム出力 

rotate OxABCD 4 bits left ■ BCDA 
rotate OxABCD 4 bits right - DABC 
rotate 0x555555551 bit left _ AAAAAAAA 
rotate OxAAAAAAAA 1 bit right - 55555555 
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_rotr 


機能 

形式 

ブロトタイプ 

解脱 

戻り価 

関連項目 

例 
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符号なし整数値をビットごとに右へローテートします。 
unsigned _rotr (unsigned value ， int count ) \ 
stdlib.h 

rotr は，与えられた値 value を count ビットだけ右へローテートします。 
ロー テートされる値は unsigned です。 

rotr は，右へビットロー テートした値を返します。 

lrotr 

rotl を参照してください。 
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sbrk 


機能 データセグメント領域の割り当てを変更します。 


形式 void * sbrk (int incr ) : 

ブロトタイプ alloc.h 

解脱 sbrk は • ブレーク値（データセグメントのすぐ後ろのアドレス）に/爪 7 •を 

加え，これに従って割り当てスペースを変更します。 mcr は負の値でもか 
まわず，その場合には割り当てスペースが小さくなります。 
sbrk は，システムで許される大きさを越えるスペースを確保しようとした 
場合にはエラーとなり，割り当てスペースの変更は行ないません。 

戻り値 割り当てスペースの変史に成功した場合， sbrk は変更前のブレーク値を返 

します。失敗した場合には -1 を返し， err / io を次の値にセットします。 

ENOMEM メモリが不足した 

可搬性 sbrk は UNIX で使用できます。 

関連項目 brk 
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scanf 


機能 スト 4ーム stdin をスキャンして書式つき入力を行ないます。 

形式 int scanf (const char * format [, address ”"]) •• 

プロトタイプ stdio.h 

解脱 scanf は，一連の入カフィールドをスキャンして，一度に1文字ずつストリ 

ーム扣か|から文字を読み込みます。次に，引数/ orma / によって指される 
麻式文字列中の宵式指定にしたがって，各フィールドを*式化します。嘏 
後に， / ormar の後に絞く各引数が示しているアドレスに，寄式化した入力 
を格納していきます。冉式文字列中の軎式指定の個数は，その後に絞くア 
ドレスの数と同じでなければなりません。 


害式文字列： 

scanf およひ•関連する関数 ( cscanf , fscanf , sscanf , vscanf , vfscanf , 
vsscanf ) の辨式文字列は，各関数が入カフィールドを，どのようにスキ 
ャンし，変換し，また格納するかを制御します。書式指定と同じ個数の 
アドレス引数が存在しなければなりません〇アドレス引数がたりない場 
合は結果は予測できない，ひどいものになるはずです。多すぎる場合は 
単に無视されるだけです。 

搿式文字列には，次の3種類のオブジェクトが含まれています。ホワイト 
スペース， 非ホワイト スペース， 窨式指定です。 

■ホワイトスベースは，空白，タブ （¥ t ), 復改 （¥ n ) です。 

• •• scanf 関数が書式文字列中のホワイトスペースに出会うと，入力に 
おけるホワイトスベースを，次に非ホワイトスペースが現われるまで 
読みとばします。 

■非ホワイトスペースは，％文字以外のすべての ASCII 文字です。 

• •• scanf 関数が書式文字列の中で非ホワイトスペースに出会うと，そ 
れに一致する文字を読みます。 

■書式指定は，… scanf 関数に，入カ フイ ールドを読んで変換し，アドレ 
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ス引数で指定される場所へ格納することを指示します。 

後に統くホワイトスベースは，軎式文字列の中でマッチするものがない 
限り，（復改も含めて）読まれません。 

書式指定： 

• •• scanf の書式指定は次のような形式をとります。 


z 【 * 】 [ 入力幅】 [F|N 】 [h|l|Lj ffi 指定文字 

害式指定は必らず％で始まります。％の後には，次に示すものが，この 
順で現われます a 


■オプションの代入抑制文字 （*) 

■オプションの入力幅指定子 

■オプションのポインタサイズ指定子 （ F または N ) 
■オブ シヨ ンの引数型修飾子 （ h , 丨または L ) 

■型指定文字 
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害式文字列中のオプシヨンの要索： 

...scanf の害式文字列の中の指定するオブションの要素の 働きを 次に 
示します。 


文字/指定子 

働き 

本 

次の人カフィールドを i 光みとばす0 

入力《 

统むべき文字数の最大値。. ..scanf 関数がホワイトスべ 

ースあるいは変換不能文字に出会った場合は，これより 

少ない文字しか统まれないこともある。 

サイズ 

アドレス引数のデフオルトのサイズを変更する0 

N = near ボインタ 

F = far ボインタ 

引数の型 

アドレス引数のデフォルトの型を変更する0 

n = short int 

/ = long int (塑指定文字が接数変換を指示している場 

合） 

/ = double (型指定文字が浮動小数点変換を指示してい 

る場合） 

し = long double (浮動小数点変換の場合にのみ有効） 
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... scanf 型指定文字： 

次の表には， ... scanf の型指定文字，期待される入力の型，入力がどのよ 
うな害式で格納されるかが示されています。 

この表に示した情報は，オプションの文字，指定子，修飾子 （* ，入力 
幅，サイズ）が書式指定に指定されていない場合のものです。オブショ 
ンを追加したときにどうなるかについては，この後の表を参照してくだ 
さい。 



型指定文字 期待される入力 引数の型 



数値 


d 

10 進祭数 

int へのボインタ （int * arg) 

D 

10 進整数 

long へのボインタ （ling * arg) 

0 

8 進整数 

int へのボインタ （int * arg) 

0 

8 進整数 

long へのボインタ （long * arg) 

• 

1 

10/8/16 進 S? 数 

int へのポインタ （int * arg) 

I 

10/8/16 進整数 

long へのポインタ （long * arg) 

U 

符号なし 10 進整数 

unsigned int へのポインタ 



(unsigned int * arg) 

U 

符号なし 10 進整数 

unsigned long へのポインタ 



(unsigned long * arg) 

X 

16 進整数 

int へのポインタ （int * arg) 

X 

16 進整数 

long へのボインタ （long * arg) 

e 

浮動小数点数 

float へのポインタ (float * arg) 

E 

浮動小数点数 

float へのボインタ （float * arg) 

f 

浮動小数点数 

float へのポインタ （float * arg) 

g 

浮動小数点数 

float へのポインタ （float * arg) 

G 

浮動小数点数 

float へのポインタ （float * arg) 
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s 

c 


% 


文字列 文字配列へのポインタ （chararg[]) 

文字 文字へのボインタ （char * arg ) 

フィールド幅 w が c についている場 
合 （％5c のように）は， w 個の文字か 
らなる配列を指すポインタ (char arg 
[w]) 

%文字 変換は，行なわれず，単に％文字が格 

納される。 


ポインタ 


(なし) 


P 16進数 

YYYY : ZZZZ 形式 


int 型へのボインタ （int * arg ) 

% n までで，正しく読み込まれた文字 
数がこの int に格納される。 

あるオブジェクト への ポインタ 
(far * または near *) 


または ZZZZ 形式 ％ p 変換は，メモリモデルにおけるデ 

フォルトのポインタサイズになる。 


フイールド： 

カフィールドは，次に示すもののいずれかです。 

I次のホワイトスペース（これは含まれない）までのすベての文字 
I現在の書式指定では変換することができない文字までのすべての文字 
(たとえば，8進形式での8または 9) 

In がフイールド幅として指定されている場合は文字まで。 
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慣例： 

害 式指定のいくつかについては，次に示すような 憤 例があります。 

% c 変換 

この指定子は，ホワイトスペースを含めて次の文字を読み込みます。ホ 
ワイトスベースをスキップし，次の非ホワイトスベースを読み込むため 
には， ％ ls を使用してください。 

%Wc 変換 （W = 入力幅指定子） 

アドレス引数は文字配列を指すポインタです。配列は W 個の要素をも 
ってい ます (char ^[ W ]) 0 

変換 

アドレス引数は文字配列を指すポインタです （char arg []) 0 
配列の大きさは少なくとも （ n +1) バイトでなければなりません。ここ 
で！！ は文字列8の長さです。空白文字あるいは復改文字は入カ フイール 
ドを終了させます。ヌル文字が自動的に文字列の最後に付•加され,配列の 
股後の要素に格納されます。 


%[探索集合]変換 

大カッコ [] で囲まれた文字は，型指定文字8に K き換えられます。アドレ 
ス引数は，文字配列を指すポインタです (char arg []) 0 
カッコの中には，入力文字列を構成する文字からなる探索槊合を定義す 
る文字を置きます。 

カッコの中の最初にキヤレット （） を S くと，探索集合は，指定されて 
いる文字以外の ASCII 文字（反転探索集合）になります（通常，最初の 
キヤレットの後にキヤレットが指定されていなければ，探索集合にはキ 
ヤレットも含まれます)〇 

入カフィールドは，ホワイトスベースで区切られていない文字列で 
す 0 . •. scanf 関数は対応する入カフィールドを，探索集合（あるいは反転 
探索集合)に含まれない文字に達するまで読みます。この変換の例を2つ 
示します。 


Z 【 abcd 】 入カフイールドの中で文字 a.b.c.d を探索する 

z r abcd ) 入カフイールドの中で a,b,c,d 以外の文字を探索する 
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また，ある範囲の文字を探索集合として簡単に使える範囲機能を使うこ 
とができます。たとえばすべての10進数を探索する次の変換指定は， 

Z[0123456789] 

より簡単に次のように害くことができます。 

: 【 0-9 】 

英数文字に関しては，以下のような指定が可能です。 

Z 【 A-Z 】 すべての英大文字 

Z[0-9A-Za-2 ] すべての败字と英大文字と英小文字 
Z[A-FT-Z) 英大文字の A 〜 F と T 〜 Z 

これらの変換ルールは簡単です。 

■ダッシュの前の文字は，後の文字よりも ASCII コードが大きい文字 
でなければいけません。 

■ダッシュは，文字列の先頭または最後にあってはいけません。もし 
先頭か最後がダッシュならば範囲指定ではなくダッシュ文字そのも 
のを探索します。 

■ダッシュの前後に指定する文字は，他の範囲の一部であってはいけ 
ません。 

以下は範囲指定にはならない例です。 

1(-+*/] 四則演算子 

れ z-a 】 z. a の探橐 

Z[+0-9-A-P] 〇〜 9 と A 〜 F 

ZI+0-9A-F-] +• -• 〇〜 9 と A 〜 F 

Zp-O-9+A-F] +, -• 〇〜 9, A 〜 F 以外の ASCII 文字 

% e , % E , % f , % g , % G (浮動小数点）変換 

入カフイールドにおける浮動/点数は次に示すような形式をとってい 
なければなりません。 

[+/-]dddddddd[.]dddd[Eje][+/-]ddd 

ここで [] で囲まれた部分はオプションであり，は1〇進，8進，16進い 
ずれかの表記の数です。 
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unsigned char，unsigned int , unsigned long を指すポインタは ， char 
int , long を指すポインタが許される変換ならば，どこでも使用できま 
す。 

代入抑制文字： 

代入抑制文字はアスタリスク （*) です。 C の間接参照（ポインタ）演算 
子もアスタリスクですから，間違えないでください。 

鲁式指定の中で％の後に * があると，次の入カフィールドはスキャンさ 
れますが，次のアドレス引数には割り当てられません。スキップされる 
入カデータは，*の後の型指定文字が示す型であるとみなされます。 

入力福指定子： 

入力幅指定子 （ n は10進数）は，現在の人カ フィ ー ル ドから読まれるべき 
文字数の上限を指定するものです。 

入カフィールドが n 文字より小さい場合は，... scanf 関数はそれらのす 
ベての文字を読み込み，次のフィールド，次の神式指定へと移ります。 
n 文字読む前に，ホワイトスベースや変換できない文字が現れた場合は, 
そこまでの文字が2光み込まれ，変換され，格納されます。その後また関 
数は次の湃式指定に移っていきます。 

変換できない文字というのは，与えられた#式にしたが っ て変換するこ 
とのできない文字（たとえば，苒式が8進のときの8や9，搿式が16進のと 
きの J や K ) のことです。 


入力幅指定子 入力幅はどのような影響を受けるか 


n 


n 文字まで読み込んで変換され，現在のアドレス引数に 
格納される。 


入カサイズおよび引数型修飾子： 

入カサイズ修飾子 （ N と F ) および引数型修飾子 （ h , 丨 および L ) 
は，... scanf 関数が対応するアドレス引数〇叹 [ f ] をどう解釈するかに影 
響を与えるものです。 

F と N は， arg のデフォルトサイズや宣言されたサイズに*先します。 
h , 1および L は，統く入カデータにどの型（バージョン）が使用される 
のか （h = short , 1= long , L = long double ) を示します。入カデー 
夕は指定のバージョンに変換され，その入カデータ対する arg は対応す 
るサイズのオブジェクトを指すことになります （％ h の場合は short の 
オブジェクト，％1の場合は long か double のオブジェクト， ％ L の場 
合は long double のオブジヱクト）。 


修飾子 変換はどのような影響を受けるか 


F デフォルトあるいは宣言されたサイズが変更され，似ぎは far 

ポインタとして扱われる。 

N デフォルトあるいは宣言されたサイズが変更され， arg は near 

ポインタして扱われる。ヒュージモデルでは，どの変換とも一 
緒には使用できない。 

h d , i , o ， u , x 型：入力を short int に変換し short 型オブジェクト 

に格納する。 

D , I ,0, U ， X 型：影響なし。 
e ， f , c , s , n , p 型：影響なし。 

1 d , i , o , u ， x 型：入力を long int に変換し， long 型オブジェクトに 

格納する。 

e , f 型：入力を double に変換し， double 型オブジ x クトに格納 
する。 

D , I ，0, U , X 型：影響なし。 
c ,8, n , p 型：影響なし。 

L e , f , g 型：入力を long double に変換し ， long double 型オブジ 

ェクトに格納する。 
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scanf がスキャンをやめる場合： 

scanf 関数は，通常のフィールド終了文字（ホワイトスペース）を読む前 
に，さまざまな理由により，あるフィールドのスキャンをやめる場合が 
あります。 

scanf 関数は，次に示すことが起きた場合には，現在のフィ ー ルドのスキ 
ャン および格納をやめて，次の入カフィールドへ移ります0 

■代入抑制文字 （*) が 書式 指定の中で％の後に指定されている場合。 

現在の入カ フィ ー ル ドはスキャンされますが，値は格納されません。 
■入力幅指定子で指定されている個数の文字を読み込んだ場合。 
■現在の書式で変換できない文字を洸んだ場合（たとえば10進形式での 

A ) 

■入カフ ィール ドの次の文字が探索リストに入っていない場合。 

これらの理由から scanf 関数が現在の入カフィールドのスキャンをや 
めたときには，次の文字は読み込まれなかったものとし，次の入カフィ 
ールドの先頭の文字となるか，あるいは次の読み込み搡作の先頭の文字 
となります。 

scanf は次の場合に終了します。 

■入カフィールドの次の文字が， 窬式 文字列の中の非ホワイトスベース 
と矛盾するとき。 

■入カ フィ ー ル ドの次の文字が EOF のとき0 
■并式文字列がすべて使い果たされたとき。 


害式文字列中に，害式指定の一部分でない文字列が現われた場合は，入 
カフィールドの現在の文字の並びと一致しなければなりません 。 scanf 
は，一致した文字をスキャンしますが格納はしません。一致しない文字 
が現われたときは，その文字はあたかも読まれなかったように，入カフ 
ィールドにとどまったままになります。 
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戻り値 


scanf は，正しくスキャンし，変換し，格納した入カフィールドの数を返し 
ます。戻り値には，値を格納しなかった入カフィールドの数は含まれませ 
ん〇 

ファイルエンドを読み込んだ場合は，戻り値は EOF になります。 

値を格納したフィールドがなかった場合は，戻り値は〇となります。 

可撤性 scanf は UNIX システムで使用でき ， ANSI C と互換性があります。 K & 

R でも定義されています。 

閣連項目 cscanf , fscanf , printf ， sscanf , vfscanf , vsscanf 
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searchpath 


機能 DOS のバスを探索してファイルを探します。 

形式 char * searchpath (const char * file ) : 


プロトタイプ dir.h 

解脱 searchpath は，/? /e で与えられたファイルを， DOS のバスを使って探しま 

す 0 DOS のバスは， PATH = •••という形式の文字列です。そのファイル 
のフルバス名の文字列を指すボインタが関数値として返されます。 
searchpath は，最初にカレントドライブのカレントディレクトリをチェ 
ック探します。ファイルがそこで見つからない場合は， 63 境変数 PATH を 
取り出して，その中の各ディレクトリの中で探索を行ないます。ファイル 
が見つかるか，パス名を使い果たすまで探索を絞けます。 

ファイルが見つかると，そのフルハ•ス名を含む文字列が返されます。この 
文字列は，そのファイルをアクセスする fopen や exec …などの呼び出しで 
使用することができます。 

この文字列は，狰的バッファの中に格納されるので，次の searchpath の呼 
び出しによって上#きされます。 

戻り值 ファイルが見つかった場合は，ファイル名を含む文字列を指すボインタを 

返します。そうでない場合は NULL を返します。 

可撤性 searchpath は MS-DOS に特有の関数です。 

閲連項目 exec ..., spawn ..., system 
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#include <8tdio.h> 
/include <dir.h> 


main() 

{ 

char *p; 

p ■ searchpathCTLIHK.EXE*); 

printf("Search for TLIHK.EXE s Zs¥n e f p); 

p _ searchpath(•NOTEXIST.PIL-); 

printfCSearch for HOTEXIST.PIL i Xs¥n* f p); 


ブログラム出力 


Search for TLIHK-EXE i Ct¥BIN¥TLINR.EXE 
Search for NOTEXIST.FIL i (null) 
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segread 


檐能 

形式 

プロトタイプ 

解説 

戻り値 

可撤性 
M 連項目 


セグメントレジスタを読み出します。 

# include <dos.h> 

void segread (struct SREGS * segp) \ 
dos.h 

segread は，セグメントレジスタの現在の値を，從 gp が指す構造体の中に 
格納します。これは， intdosx や int 86 x とともに使用する目的で呼び出さ 
れます。 

ありません。 

segread は 80x86 ファミリイのプロセッサに特有の関数です。 

FP OFF , intdos , int 86, MK FP , movedata 
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setblock 


機能 

形式 

プロトタイプ 

解脱 

戻り値 

可撤性 

M 連項目 
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以前に割り当てられたブロックの大きさを変更します。 


int setblock (unsigned segx , unsigned newsize ) : 


dos.h 

setblock は，メモリセグメントの大きさを変更します。货ぎズには，以前の 
allocmem の呼び出しで返されたセグメントアドレスを指定します。 news ¬ 
ize には，新たに要求するメモリ tt をバラグラフ卑位で与えます。 

setblock は，成功した場合には -1 を返します。エラーの場合は確保可能な 
肢大のブロックサイズを返し， do 8 errno をセットします。 


setblock は MS - DOS に特有の関数です。 


allocmem 
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setbuf 


機能 ストリームにバッファリングを割り当てます。 

形式 # include く stdio . h 〉 

void setbuf (FILE * stream 、char * buf ) : 


プロトタイプ stdio.h 


解脱 setbuf は，自動的に割り当てられたハ•ッファにかえて，八ッファ* w / を 1/ 

0 八ッファ リングに使用できるようにします。 この八ッファは， stream を 
オーブンした後で使用されます。 

buf が NULL の場合は， I/O はバッファリングされません。それ以外の場 
合は完全にバッファリングされます。バッファの大きさは BUFSIZ (stdio. 
h の中で定我されている）バイトなければなりません。 

幻如と stdout は， リダイレクトされていなければバッファリングされま 
せん。そうでない場合は完全にバッファリングされます。 setbuf は，使用 
される八ッファリングの形式を変更するためにも使えます。 
バッファリングをしない場合，ストリームに文字を冉き出すと，すぐにフ 
ァイルやデハ•イスに出力されます。バッファリングする場合は，文字はバ 
ッファに畨えられ，ブロック単位で湃かれていきます。 
setbuf は， stream をオーブンした直後，あるいは fseek を呼び出した直後 
以外に呼び出すと予期できない結果が生じます。 stream をバッファリング 
しないと指定した後で setbuf を呼び出すのは正当であり問題は起こりま 
せん。 

よく起こるエラーの原因として，バッファを自動（ローカル）変数に割り 
当ててしまうことがあります。バッファが宣言された関数から戻る前に， 

ファイルをクローズするのを忘れてしまうことが多いのです。 

戻り 値 ありません。 

可搬性 setbuf は UNIX システムで使用でき， ANSI C と互換性があります。 
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関連項目 

例 


fflush , fopen , fseek , setvbuf 
setvbuf を参照してください。 
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setcbrk 



コント ロール ブレークの設定をセットします。 


int setcbrk unt corkvalue ) 


dos.h 


setcbrk は， DOS システムコール 0 x 33 を使って，コントロールブレークチ 
エックをオンまたはオフに設定します。 

cbrkvalue = 0 オフにする（コンソール，ブリンタ，通信デバイスの 

I / O においてのみチェックを行ないます ）0 


クを行ないます)。 


戻り値 


setcbrk は， 渡された値 cbrkvafue を返します f 


可搬性 


setcbrk は MS - DOS に特有の関数です。 


関連項目 


getcbrk 
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setdate 


機能 DOS の日付をセットします。 

形式 # include <dos.h> 

void setdate (struct date * datep ) \ 

ブロトタイプ dos.h 

解脱 setdate は， datep が指す date 構造体の中に入っている日付を，システムの 

H 付（月，日，年）にセットします。 
date 構造体は次のように定我されています。 

struct date { 

int da_year； /* 年 */ 

char da^day; /* 日*/ 

char da_mon； /* 月貪/ 

}； 


戻り値 

ありません。 

可搬性 

setdate は MS - DOS に特有の関数です。 

間連項目 

g ： etdate 9 g ： ettime f settime 

例 

getdate を参照してください 0 
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setdisk 


機能 カレントディスクドライブをセットします0 

形式 int setdisk (int drive ) \ 

ブロトタイプ dir.h 

解脱 setdisk は，カレントドライブをみ/•叱に指定されたものにします （0 = A , 

1 = B , 2=0。 DOS システムコール OxOE と同じです。 

戻り 値 setdisk は，利用可能なドライブの総数を返します 0 

可撤性 setdisk は MS - DOS に特有な関数です。 

関連項目 setdisk 
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setdta 


機能 

形式 

プロトタイプ 

解脱 

戻り値 
可撤性 

閏連項目 


362 


ディスク転送アドレスをセットします。 


void setdta (char far * dta). 


dos.h 


setdta は，ディスク転送アドレス （ DTA ) の現在の設定を，ゴ如に指定さ 
れた値に変更します。 

ありません。 

setdta は MS - DOS に特有のものです。 


getdta 
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setftime 


機能 

形式 

プロトタイプ 

解脱 


戻り値 

可撤性 

関連項目 

例 


ファイルの日付と時刻をセットします。 


# include < io . h > 

mt setftime unt handle , struct ftime * ftimep ) \ 


io.h 


setftime は，オーブンされているに結びつけられているディスク 
ファイルのファイル時刻 • 日付に， ftimep が指す ftime 構造体に格納され 
ている日付•時刻をセットします。 
ftime 構造体は次のように定我されています。 


struct ftime { 

unsigned ft — tseci 5; 
unsigned ft 一 min: 6; 
unsigned ft 一 houri 5; 
unsigned ft 一 dayi 5; 
unsigned ft_monthi4; 
unsigned ft_yeari 7; 
)5 


/* 秒 （2 妙単位） 
/* 分 
/* _ 

I 食日 

/* 月 

/* 年- 1980 



成功した場合， setftime は0を返します。 

エラーの場合は-1を返し， errno に次のいずれかをセットします。 


EINFNC 無効なファンクション番号 
EBADF フアイル番号が正しくない 


setftime は MS-DOS に特有の関数です。 


getfume 


getdate を参照してください 0 
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setjmp 

機能 ノンローカル goto のための セッ トアップを行ないます。 

形式 # include < setjmp . h > 

int setjmp(jmp buf jmpb ) : 

プロトタイプ setjmp.h 

解脱 setjmp は，現在の完全なタスクの状態をとらえてノ に格納し，0を返し 

ます。 

setjmp を行なった後で， その jmpb を引数として longjmp を呼び出すと, 
jmpb に入っていたタスクの状態が回復され， setjmp が値 va / を返したか 
のようにリターンします0 
タスクの状態とは以下のものをいいます。 

■すべてのセグメントレジスタ （ CS , DS ， ES ， SS ) 

■レジスタ変数 （ SI , DI ) 

■スタックポインタ ( SP ) 

■フレームベースポインタ （ BP ) 

■フラグ 

タスクの状態は，コルーチンを実現するために setjmp が使用されるのに 
充分なものです。 

setjmp は， longjmp より前に呼び出しておかなければなりません。 setjmp 
を時んで jmpb を設定したルーチンは， longjmp が呼び出されるまではァ 
クティブなままでなければならず，リターンすることはできません。もし, 
そうしてしまった場合は，結果は予測できません。 

setjmp は，ブログラムの低レベルサブルーチンにおいて起こるエラーや例 
外を処理する際に便利なものです。 

戻り値 setjmp は，最初に呼び出されたときは〇を返します。 
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可撤性 
間連項目 

例 


setjmp は UNIX システムで使用でき ， ANSI C と互換性があります。 

longjmp , signal 

longjmp を参照してください。 
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setmem 


機能 ある範囲のメモリに値を代入します。 

形式 void setmem (void * dest, unsigned length 、char value ) : 

ブロトタイプ mem.h 

解脱 setmem は， dest が指すブロックの先頭から length 八イトを， value で埋め 

ます。 

戻り値 ありません。 

可搬性 setmem は8086ファミリィに特有の関数です。 

閱連項目 memset , strset 
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setmode 


機能 オーブンファイルのモードをセットします。 


形式 # include く fcntl . h 〉 

int setmode unt handle , mt amode ) \ 


プロトタイプ io.h 

解脱 setmode は， handle に結びつけられているオーブンファイルのモードを， 

バイナリかテキストにセットします。引数 amorfe は，0 BINARY ^ 0 
TEXT のどちらかの値でなければなりません（これらのシンボリック定数 
は fcntl . h の中で定義されています)。 

戻り値 setmode ( i , 成功した場合は0を返します。エラーの場合は-1を返し ， errno 

に ENIVAL (引数が正しくない）をセットします。 

可搬性 setmode は UNIX システムで使用できます 

閣連項目 creat , creat , ooen , open 
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settime 


機能 システム時刻をセットします。 

形式 # include <dos.h> 

void settime (struct time * timep ) \ 

プロトタイプ dos.h 

解脱 settime は， timep が指す time 構造体の中に人っている時刻をシステムの 

時刻にセットします。 

time 構造体は次のように定義されています。 

struct time { 

unsigned char ti 一 min; 
unsigned char ti hour 
unsigned char ti 一 hund 
unsigned char ti sec; 

)； 一 

戻り値 ありません。 

可搬性 settime は MS - DOS に特有の関数です。 

関連項目 ctime , getdate ， gettime ， setdate , time 


/* 分 *1 

/* m */ 

/* 1/100 秒*/ 
/* 秒 */ 
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setvbuf 


機能 ストリームにバッファリングを割り当てます。 

形式 # include く stdio . h 〉 

int setvbuf (FILE * stream ，char * buf t int type , size t size ) : 

プロトタイプ stdio.h 

解脱 setvbuf は，自觔的に割り当てられる バッファに かえて， バッファ を 

I / O 八 ッファ リングに使用できるようにします。この バッファは， stream 
をオーブンした後で使用できるようにな0ます。 

buf が NULL の場合は，バッファは malloc を使って確保されます。バッ 
ファに確保される領域の大きさとして 5 加が使われます。 引数 size はバッ 
ファの大きさを指定するものであり，ゼロより大きくなければなりません。 


注意： J 加の肢大値は32767に制限されます。 


幻 din と stdou " i 、 リダイレクトされていなければ八ッファリングされま 
せん0そうでない場合は完全にバッファリングされます。 
バッファリングをしない場合，ストリームに文字を冉き出すと，すぐにフ 
ァイルやデハ•イスに出力されます。ハ•ッファリングする場合は，文字はバ 
ッファに蒂えられ，ブロック単位で冉かれていきます。 

引数 type は次のいずれかです。 

JOFBF ファイルは完全にバッファリングされます。つまり，入力操 
作はバッファがいっぱいになるまで行なわれます。出力では, 
バッファが完全にいっぱいになるまでファイルに斟き出され 
ません。 

_IOLBF ファイルは行バッファリングされます。入力操作は，上と同 
様にバッファがいっぱいになるまで行なわれます。出力では， 
復改文字が害かれたときにバッファがフラッシュされます。 
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IONBF ファイルはバッファリングされません。办 w / と size 引数は無 
視されます。各入力操作はファイルから直接行なわれます。 
出力も，データが害かれるとすぐにファイルに害き出されま 
す。 

よく起こるエラーの原因として，バッファを自動（ローカル）変数に割り 
当ててしまうことがあります。八ッファが宣言された関数から戻る前に • 
ファイルをクローズするのを忘れてしまうことが多いのです。 

戻り値 setvbuf は，成功した場合は0を返します。07疋とぬぞに正しくない値を与 

えた場合，およびバッファを確保するための充分な領域がなかった場合に 
は，0以外の値を返します。 

可撤性 setvbuf は UNIX システムで使用でき ， ANSI C と互換性があります。 

閲連項目 fflush ， fopen , setbuf 
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: up buffer for input file¥n *)： 

> for input file¥n *)； 

n .malloct 的に鮮び出して 

《ツファリングを行なう • 

• • •IOLBF, 132) I- 0) 

: up buffer for output file¥n •: 


for output file¥n*)j 


setvect 


機能 割り込みベクタエントリをセットします。 

形式 void setvect (int interruptno , void interrupt (* isr )()) : 


プロトタイプ dos.h 


解脱 8086 ファミリイのすベてのプロセッサは割り込みベクタのセットを持って 

おり，これには〇〜255の番号がふられています。各べクタの中の4バイト値 
は，割り込み関数が*かれている場所を示すアドレスです。 
setvect は， intrruptno で指定されたべクタの値に，新しい値 w をセットし 
ます。かは，新しい割り込み閱数のアドレスを含む far ポインタです。 C の 
ルーチンを interrupt ルーチンと宣言している場合には， w に渡せるのは 
そのルーチンのアドレスだけになります。 

注意： dos.h で宣言されているブロトタイブを使えば，どのメモリモデル 
においても，割り込み関数のアドレスを setvect に渡すことができます。 

戻り値 ありません。 

可搬性 setvect は8086ファミリイのプロセッサに特有の関数です。 

関連項目 getvect 
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setverify 


機能 ベリファイフラグの状態をセットします0 

形式 void setverify (int value ) \ 


ブロトタイプ dos.h 


解脱 setverify は，ベリファイフラグの状態を value にセットします。 

value = 〇 ベリファイフラグオフ 
value =1 ベリファイフラグオン 

ベリファイフラグはディスクへの出力を制御します。ベリファイがオフの 
ときには# f き込みの照合（ベリファイ）は行なわれず，ベリファイがオン 
のときはすべてのディスクへの淋き込みにおいて，データが適切に冉き出 
されたかどうかを確かめるために照合が行なわれます。 

戻り偭 ありません。 

可搬性 setverify は MS - DOS に特有の関数です 0 

関連項目 getverify 
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signal 


機能 シグナル処理搡作を指定します。 

形式 # include く signal . h 〉 

void (木 signal(int sig , void (* func ) (int sig [,int subcode ]))) ( int ) : 


プロトタイプ signal.h 


解脱 signal は， シグナル 番号抑 が受け取られた後でどのように 処理され るか 

を決定します。ユーザ指定のハンドラルーチンをインストールすることも 
でき， signal . h の中であらかじめ定我されている2個のハンドラのいずれか 
を使うこともできます。 

2つの定義済みハンドラは次の通りです。 


関数ポインタ 

意味 

SIG 一 DFL 

ブログラムを終了する。 

SIGJGN 

この型のシグナルは無視する。 


signal . h の中で定義されている3番目の定義済みハンドラは SIG _ ERR で 
す。これは， signal からのエラー戻りを示すために使われます。 
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シグナル型およびそのデフォルト値は次の通りです0 


シグナル型 意味 


SIGABRT 異常終了。デフォルト動作は _ exit ⑶の呼び出しと同じ。 
SIGFPE ゼロ除算などの正しくない操作によって引き起こされた 

数学的なエラー。デフォルト動作は _ exit ( l ) の呼ひ•出し 
と同じ。 

SIGILL 不当な操作。デフォルト動作は _ exit ⑴の呼び出しと同 

じ。 

SIGINT CTRL « C 割り込み。デフォルト動作は INT 23 H の実行。 

SIGSEGV 主記值への不当なアクセス。デフォルト動作は _ exit ( l ) 

の呼び出しと同じ。 

SIGTERM ブログラム終了要求。デフォルト動作は _ exit ⑴の呼び 

出しと同じ。 


signal . h は ， sig atomic t という型を定我しています。これは，非同期の割 
り込みの存在下でアトム的にプロセッサがロー ドやセーブすることができ 
る最大の! S 数型です （8086 ファ ミリィでは，これは16ビットワード，すな 
わち Turbo C の整数)。 

raise 関数，あるいは外部イベントによってシグナルが生成された場合，以 
下のことが行なわれます。 

1. そのシグナルに対してユーザ指定のハンドラがインストールされてい 
れば，そのシグナル型に対する動作が SIG — DFL にセットされます。 

2. ユーザ指定の関数が，シグナル型を引数として呼び出されます。 

ユーザ指定の ハン ドラ関数は， return 文や abort , exit , exit , longjmp の 

呼び出しで終了することができます。 
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Turbo C は，シグナル型が SIGFPE , SIGSEGV , SIGILL の場合には， 
ANSI C への拡張をインブリメントしています。ユーザ指定のハンドラ関 
数は，引数を1つあるいは2つ追加して呼び出されます。 raise 関数を明示的 
に呼び出した結果として， SIGFPE , SIGSEGV , SIGILL のいずれかが発行 
された場合，ユーザ指定のハンドラ関数は，そのハンドラが明示的に呼び 
出されていることを示す整数値を追加引数として呼び出されます。 SIG ¬ 
FPE , SIGSEGV , SIGILL に対する明示的呼ひ•出しの値は次のようになっ 
ています （ float . h の中の宣言を参照してください)。 


シグナル型 

起動値 

SIGFPE 

FPE_EXPLICITGEN 

SIGSEGV 

SEGVEXPLICITGEN 

SIGILL 

ILLEXPLICITGEN 


SIGFPE が浮動小数点例外によって発行された場合， ユーザハン ドラは， 
そのシグナルの FPE _ xxx 型を示す追加引数をともなって呼び出されます。 
プロセッサ例外の結果として， SIGSEGV ， SIGILL , あるいは SIGFPE シ 
グナルの変神 : （FPE INTOVFLOW または FPE INTDIVO ) が引き起こさ 
れた場合には， ユーザ ハンドラは2つの追加引数をともなって呼び出されま 
す。 

1. SIGFPE , SIGSEGV , あるいは SIGILL の例外型（これらの型につ 
いては float . h を参照してください）。この最初の引数は通常の 
ANSI のシグナル型です。 

2. ユーザ指定のハンドラを呼び出した割り込みハンドラのスタックの 
中を指す S ? 数ポインタ。このポインタは，例外が発生したときに退 
避されたプロセッサレジスタのリストを指します。レジスタは，割 
り込み関数への引数と同じ順序で並んでいます。つまり， BP , DI ， SI , 
DS , ES , DX , CX , BX , AX , IP , CS , FLAGS の順です。 ハン ドラが 

リターンするときにレジスタの値を変更したい場合は，このリスト 
における対応する部分を変更します。たとえば， SI に新しい値をセ 
ットしたい場合は次のようになります。 
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*((int *)list_pointer + 2) - new—SI 一 value; 

このようにして，ハンドラはレジスタの値を調べたり，新しい値に 
変更することができます（後に示す 例 2を参照してください)。 

次に示す SIGFPE 型のシグナルが起こり得ます（あるいは生成され得ま 
す）。これらは，メイン CPU における ” INTEGER DIVIDE BY ZERO ”， 
’’INTERRUPT ON OVERFLOW ” に加えて， 80 x 87 が検出することがで 
きる例外にも対応しています。これらの宣言は float . h の中にあります。 


SIGFPE シグナル 

意味 

FPE 一 INTOVFLOW 

OF フラグをセットして INTO 命令を実行 

FPEINTDIV 0 

ゼロによる格数の除菸 

FPE INVALID 

不当な操作 

FPEZERODIVIDE 

ゼロによる除斿 

FPEOVERFLOW 

数値ォーバーフロー 

FPE UNDERFLOW 

数侦アンダーフロー 

FPEJNEXACT 

稍度 

FPEEXPLICITGEN 

ユーザブロ グラムが raise ( SIGFPE ) を実行 


注意： FPE _ INTOVFLOW と FPE INTDIV 0 シグナルは，整数に対する 
操作によって生成されます。その他は浮動小数点に対する操作によって生 
成されます。浮動小数点例外が生成されるかどうかは，コプロセッサ制御 
ワードに依存します。コプロセッサ制御ワードは _ control 87 を使って変更 
することができます。デノーマル（不正規化数）例外は Turbo C によって 
処理され，シグナルハンドラには渡されません。 
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次の SIGSEGV 型のシグナルが起こり得ます。 


SIGSEGV シグナル 

意味 

SEGVBOUND 

SEGV 一 EXPLICITGEN 

bound コンストレイント例外 

raise ( SIGSEGV ) が実行された 


注意： 8088および8086プロセッサは bound 命令を備えていません。80186/ 
286/386,およひ • NEC の V シリーズのプロセッサはこの命令を持ってい 
ます。したがって，8088および8086プロセッサでは， SIGSEGV シグナルの 
SEGV BOUND 型は起こり得ません。 TurboC は bound 命令を生成しま 
せんが，インラインコードや独立にアセンブルされリンクされるアセンブ 
リ言語ルーチンの中では使用され得ます0 


次の SIGILL 型のシグナルが起こり得ます。 


SIGILL シグナル 

窓味 

ILL 一 EXECUTION 

不当な操作が试みられた 

ILL_EXPICITGEN 

raise ( SIGILL ) が実行された 


注意： 8088，8086, V 20, V 30 プロセッサは不当操作例外をもっていませ 
ん。186, 286, 386, V 40, V 50 プロセッサはこの例外型を持っています。 
したがって，8088, 8086, V 20, V 30 ブロセッサでは SIGILL シグナルの ILL 
EXECUTION 型は起こりネ导ません。 
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戻り値 

可嫌性 
閫連項目 
例1 


注意：シグナル型が SIGFPE ； SIGSEGV ， SIGILL の場合は，8087の状態 
が正しくなくなっている，整数除算の結果が間違っている，オーバーフロ 
一すべきでない操作が行われた， bound 命令が失敗した，不当な操作が行 
なわれたなどのいずれかであるので，シグナルハンドラから戻ることは一 
般に望ましいものではありません。唯一の例外は • ハンドラがレジスタを 
変更して理にかなったリターンの状況が作り出されるか，シグナル型がそ 
のシグナルは明示的に生成されたものであることを示している場合です 
(例 ： FPE 一 EXPLICITGEN , SEGV 一 EXPLICITGEN , ILL . 
EXPLICITGEN )。 一般にこのような場合は，エラーメッセージを表示し， 
exit , exit , abort を使用して，ブログラムを終了させるのが良いでしよ 
う。そうでない場合は，ブログラム統行の際にどのような事態になるかは 
予想ができません。 

呼び出しが成功した場合， signal は，指定されたシグナル型に対するハン 
ドラルーチンを指すポインタを返します。呼び出しが失敗した場合は SIG 
ERR を返し， errno に EINVAL をセットします。 


signal は ANSI C と互換性があります。 


abort , control 87, ctrlbrk , exit ， longjump , raise，setjmp 


I* この例では，シグナルハンドラルーチンを， CTRL-C が抨されたときに 
寅行されるようにインストールします . *1 

/include <stdio.h> 

# include <signal.h> 


void Catcher(int sig) 

{ 

printf("ynNow in break routine¥n*); 
exit(l); 


main() 

{ 

signal(SIGINT t Catcher); 
for(;;) 

printf( B ¥nIn main() program¥n"); 
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螯数のオーバーフロー条件をとらえ，謂 & 値を AX にセットして t 
リターンします • *1 


#pragma inline 
/include <stdio.h> 

/include <signal.h> 

void Catcher(int sig f int type f int *reglist) 

{ 

printf("Caught it!¥n B )； 

*(reglist+8) - 3; /* AX に 3 を返す */ 


main() 


signal(SIGFPE, Catcher); 
asm mov ax, 07PFFH 

asm inc ax 

asm into 


AX - 32767 ★/ 

オーバーフローを起こす */ 
ハンドラをアクテイブにする 


ハンドラは AX に 3 を返す • それが起こらなければ • dec 命令の後の 
into が実行されたときに • 他の例外が発生する */ 


asm 

asm 


dec 

into 


/* オーバーフローなし */ 

/* ハンドラはアクティブにならない */ 
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機能 


正弦を求めます。 


形式 # include く math.h 〉 

double sin (double x ) : 

プロトタイプ math.h 

解脱 sin は，入力値の正弦（サイン）を計算します。角度 x はラジアン単位で指 

定します。 

戻り値 sin は，人力値の正弦を- 1 〜 1 の範囲で返します。 

sin のエラー処理は， matherr を使って変更することができます。 

可搬性 sin は UNIX システムで使用でき ， ANSI C と互換性があります。 

W 連項目 acos , asin , atan , atan 2, cos , cosh , tan . tanh 
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sinh 


機能 

双曲線正弦を求めます。 

形式 

# include < math . h > 


double sinh (double x ) : 

プロトタイプ 

math.h 


解脱 sinh は，実数の引数の双曲線正弦（ハイハ•ボリックサイン）を計算•しま 

す。 

戻り値 sinh は，ズの双曲綠正弦を返します。 

計算結果がオーパーフローする場合は， sinh は適切な符号の HUGE VAL 
を返します。 

sinh のエラー処理は， matherr 関数で変史することができます。 

可*性 sinh は UNIX システムで使用でき， ANSI C と互換性があります。 

関連項目 acos t asin , atan , atan 2, cos , cosh , sin , tan , tanh 


382 


第 2* Turbo C ライブラリ 



機能 実行を一定時間停止します。 

形式 void sleep (unsigned seconds ). 


プロトタイプ dos.h 

解脱 sleep を呼び出すと，現在実行中のブログラムは，引数從⑺乃みに指定され 

た秒数だけ実行を停止します。停止時間は， PC .9801 では DOS のクロッ 
ク ， IBM PC では1/100秒単位の近似値になります。 

戻り値 ありません。 

可撤性 sleep は UNIX システムで使用できます。 

間連項目 delay 
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sopen 


機能 シェアドファイルをオーブンします。 

形式 # include く fcntl . h 〉 

# include < sys ¥ stat . h > 

# include < share . h > 

# include < io . h > 

int sopen (char * path , int access , int sh / lag , int mode ) : 
プロトタイプ io.h 


解脱 sopen は， path に指定しされたファイルを， access , shflag , および mode の 

値にしたがって，洸み出し，#き込み，あるいは両用のシヱアドファイル 
としてオーブンします。 

sopen は，マクロとして次のように定莪されています。 

open(path, (access) | (shflag) 9 mode) 


引数 accew は，次に示す 2 つのリストのフラグをビットご: 
とによって作ります。 リスト 1からは1つのフラグしか選べ 
2では，抜数のフラグを組み合わせることができます。 





リスト 1: 読み出し/害き込みフラグ 

0_ RD 0 NLY I 充み出し専用としてオーブン 

0_ WR 0 NLY 冉き込み痒用としてオーブン 

0 RDWR 読み出しおよび苒き込み用としてオーブ 


リスト 2 :他のアクセスフラグ 


0 一 NDELAY 
0一 APPEND 
0 —CREAT 

OTRUNC 
0 —EXCL 
0一 BINARY 
0 TEXT 


使用されません。 UNIX とのコンパチビリティを図る 
ためのものです。 

これがセットされていると，ファイルポインタはまず 
ファイルの終わりに位 S づけられます。 

指定のファイルがすでに存在していれば，このフラグ 
は意味を持ちません。存在していなければ，ファイル 
は新規に作成され， m 供かのビットは chmod の場合と 
同様にして，«性ビットにセットされます。 

ファイルが存在している場合は，その佼さは0に削られ 
ます。ファイル«性はそのままで変化しません。 
使用されません。 UNIX とのコンパチビリティを図る 
ためのものです。 

このフラグは，明示的にバイナリモードでファイルを 
オーブンすることを示すのに使用されます。 

このフラグは，明示的にテキストモードでファイルを 
オーブンすることを示すのに使用されます。 


これらの•••シンボリック定数は， fcntl . h の中で定我されています。 
0_ BINARY も 0_ TEXT も与えられていない場合は，ファイルは，グロー 
バル変数-/) node にセットされている変換モードでオーブンされます。 
0_ CREATE フラ ブが access を作るために使われている場合は，引数 
を次に示すシンボリック定数から作る必要があります。 


mode の値 

アクセス許可 

S」WRITE 

擀き込み可 

SJREAD 

読み出し可 

SJREAD | SJWRITE 

読み害き可 
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弓傲 shflag には，ファイ ル path に対して許可されるファイルシェ 
グモードを指定します。以下の定数が share.h の中で定義されてい: 





こ不可 


許可 

許可 


戻り値 成功すると， sopen は負でない整数（ファイルハンドル）を返し，ファイル 

の現在位 3 E を示すファイルポインタをファイルの先頭に K きます。 エラー 
の場合は-1を返し， errm > に次のいずれかの値をセットします。 

ENOENT パス名またはファイル名が見つからなかった 

EMFILE オーブンされているファイルが多すぎる 

EACCESS アクセスが拒否された 

EINVACC アクセスコードが正しくない 

可撤性 sopen は UNIX システムで使用可能です。 UNIX バージョン7では，〇型 

のニーモニックは定義されていません。 UNIX システム III は ， O BINAR - 
Y を除くすべての0_型ニーモニックを使用しています。 

閣連項目 chmod ， close , creat , lock , ( seek ， open , open , unlock 
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sound (PC-9801) 


機能 

形式 

プロトタイプ 

機能脱明 


ビープ音の波形を指定します。 


unsigned int sound (unsigned jrequencv ). 


dos.h 


sound は，ビープ音の波の間隔（周期） / r 叫 wem : 夕を指定します。実際に音 
を発生するのは beep によって行ないます。 

beep は，指定した繰り返し回数//★だけ波を発生します。このとき，波の 
間隔/印分從爪:少と，繰り返し回数" me の関係は次のようになります。 



したがって，単位周期 =/ r 印 wem : 少 X 2 となります。 

たとえば，定時間で波の間隔（周期）を変えて音を出力したいときは，次 
の式の a を一定に保つようにしてください。 


frequency X time = a 

下記のブログラムでは，最初に単位周期20で繰り返し回数5000で比較的商 
ぃ音が発生し，次に単位周期1000で繰り返し回数100で比較的低ぃ音が発生 
します。ともに音の発生時間は同じです。 

cyce - 50000? 

freq _ 10; sound (freq) ; beep(cyce/freq); /* 高い音 */ 
freq - 500; sound (freq); beep(cyce/f req); /* 低い音 */ 

また，一番高い音は波の間隔（周期）/夕を〇にしたときです。 
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戻り値 

可撤性 

閗連項目 

例 
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注意 1: frequency は，本来は周波数の意味ですが， PC -9801 シリーズでは 
逆数の意味である周期として扱っています。 


注意 2:マシンのタイプにより，また基本クロックの違いにより音色が変 
化するので，各マシンに合わせて調整してください。 

sound li , 直前に設定されていた波の間隔（周期）を返します。 

この関数は PC -9801 シリーズでのみ動作します。 

beep 

#include <dos.h> 
void beepbeep() 


unsigned f; 
f _ 8 ound( 10 )； 

/* 直碗の值を退遁する 

*/ 

beep(50000 / 10 )； 

/* 高い眘 

*/ 

sound<700>; 
beep(50000 / 700 )； 

/* * い音 

*/ 

80 und(f); 

/* 以錡の值を復元する 

*/ 
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sound (IBM PC) 


機能 

形式 

プロトタイプ 

機能脱明 

戻り値 

可搬性 

間連項目 

例 


pc のスピーカを指定の周期で鳴らします。 


void sound (unsigned frequency ). 


dos.h 

sound は， PC のスピーカを指定の周期で鳴らします。 frequency には咅の 
周期をヘルツ（回数/秒）単位で指定します。 sound によって鳴り出したス 
ビーカを止めるには， nosound を呼び出してください。 

ありません。 

sound は ， IBM PC とその互換機でのみ動作します 。 Turbo Pascal にも 
同様なルーチンがあります0 


delay , nosound 


/* 7 -Hz の音を10秒間隽生させます. 

本雄の話： 7- Hz は•鷄の頭蓋骨の中で共鳴する音の用期です. 
これは，オーストラリアのある*しい工場で鋟驗的に得られた 
18果です. 7 -Hz の音を凴するその工場は養鷄場のすぐ近くに 
位置していましたが，工場の*業が始まると • 養鷗場の鷗がす 
ベて死んでしまつたのです. 

PC によつては， 7 - Hz の音は角生しないかもしれません. 

main() 

{ 

80und(7 ) ； 
delay(lOOOO )； 
no 80 und(); 
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spawn." 


機能 子ブロセスを生成して実行します。 

形式 # include <process.h> 

# include 〈 stdio.h 〉 

int spawnKint mode , char * path ， char * argO 、 argl , 

…， argn t NULL ) : 

int spawnle(int mode , char * path , char * argO , argl 、 

…， argn , NULL , char * envp []) : 
int spawnlp(int mode , char * path 、 char * argO , argl 、 

…， argn , NULL ) : 

int spawnlpe(int mode , char * path 、 char * arg 0 9 argl 、 

• ••, argn , NULL , char * envp []) \ 
int spawnv(int mode 、char * path 、char * argv []) : 
int spawnve(int mode , char 本 path , char 本 argv [] % char 本 envp []) : 
int spawnvp(int mode , char * path , char * argv []) : 
int spawnvpe(int mode , char * path , char 本 argv [], char * envp []) : 

ブロトタイプ process.h 

解脱 spawn •••ファミリィの関数は，子ブロセスを生成して実行します。子ブロセ 

スをロー ドし，実行するのに充分なメモリが存在していなければなりませ 

ん〇 

mode の値は ， spawn •••を呼び出した後，呼び出し関数（親ブロセス）がと 
る動作を指定するものです。 mo みに指定する値は以下の3つです。 

P WAIT 子ブロセスが実行を終了するまで親ブロセスを 

一時停止状態にする。 

P_NOWAIT 子ブロセスの実行と平行して親ブロセスも実行 

を統ける。 

P_OVERLAY 親プロセスが占めていたメモリ領域に子ブロセ 

スをオーバーレイする。 exec •••呼び出しと同じ。 
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注意： P _ NOWAIT は現在使用できません。使用するとエラー値を発生し 
ます。 

path は， 呼び出される子ブロセスのファイル名です。 spawn •••関数を呼び 
出すと， DOS の標準探索アルゴリズムを使って P 如/！が探されます。 


■拡張子もピリオドもないとき：その名前のファイルを探します。見つ 
からない場合は， . COM を付•加してもう一度探します。それでも見つ 
からなければ. EXE をイ寸加してもう一度探します。 

■拡張子が与えられているとき：その名前のファイルだけを探します。 

■ピリオドが与えられているとき：拡張子のないそのファイルだけを探 

します。 

■ spawn •••間数にサフィ ッ クス p がついている場合， PWA にディレクト 
リが明示されていなければ，まずカレントディレクトリを探し，次に 
DOS の®境変数 PATH に指定されているディレクトリを探します。 

ファミリィ名 spawn の後につけるサフィックス（接尾辞） l ， v ， p , e は，その 
関数がどのように動作するかを示しています。 

p DOS の S 3 境変数 PATH に指定されているディレクトリの中で 

子ブロセスを探します。ただし， pflrA にディレクトリ名が含まれ 
ている場合はそこを先に探し，次に S 3 境変数 PATH を調べます。 
p 如/?にディレクトリ名が含まれていない場合は，カレントディレ 
クトリを先に探します 0 p がつかない場合は，ルートとカレントデ 
ィレクトリしか探されません。 

1 引数ポインタ argO t argl ， •••， argn は， 1つずつ独立した引数とし 
て渡されることを意味します。丨は通常，渡す引数の数があらかじ 
めわかっているときに指定します。 

v 引数ポインタ argv [0]. flrgv [/ 2 ] は，ポインタの配列として 

渡されることを意味します。 v は通常，可変個の弓 I 数を渡すときに 
指定します。 

e 引数 e / ivp を子プロセスに渡して，環境を変更できることを意味 

します。 e がない場合は，子ブロセスは親プロセスの環境を受け継 
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ぎます。 


spawn •••ファミリ ィ の各関数は，引数の指定に関するサフィ ッ クス （1 また 
は v ) のいずれかを含んでいなければなりません。バス探索と環境の受け継 
ぎに関するサフィックス （ p とはオブションです 0 たとえば次のように 
なります。 

■ spawnl は，独立した引数をとり，ルートおよびカレントディレクトリ 
の中でだけ子ブロセスを探し，親ブロセスの環境を子ブロセスに渡す。 

■ spawnvpe は，引数ポインタの配列をとり，子ブロセスを探すのに環 
境変数 PATH を使い，子ブロセスの環境を変更するために州 vp 引数 
を受け入れる。 

spawn •••関数は，少なくとも1つの引数 ( argO または argv [0]) を子ブロセ 
スに渡さなくてはなりません。慣例上この引数は/^从です（違う攸を使っ 
てもエラーにはなりません）。 

DOS 3.0 以降では子ブロセスで/ w / A を使用できますが，それより前のバー 
ジョンでは子ブロセスは〇番目の引数 （ argO または^[〇])の値を使うこ 
とはできません。 

サフィックス1がついている場合， argO は path を指し， argl , org / i は 
新しい引数リストを W 成する文字列を指します。の後ろの NULL は 
リストの®:後であることを示します。 

サフ ィッ クス e がついている場合は，新しい環境設定のリストを引数伙 vp 
を通して子ブロセスに渡すことができます。⑼ vp は， char ポインタの配列 
で，次のような形式のヌル文字で終わる文字列を指しています。 


enwar _ value 


に value が代入されます。 e /? v /7[] の®:後の要素は NULL です 。 envp 
[0] が NULL のとき，子ブロセスは親ブロセスの環境設定を受け継ぎま 
す。 

argO + argI + ."+argn (または argv [0 ]+a 厂 gv [ l ] + … + argv [”]) の合計 
の長さは，引数を区切る空白文字も含めて，127バイト以下でなければなり 
ません。ヌル文字はこれには入りません。 

spawn •••関数が呼び出されたときにオープンされている ファ イルは，子プ 
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ロセスにおぃてもオーブンされたままです。 

戻り 値 成功した場合，戻り値は子ブロセスの終了ステータス（正常終了の場合は 

0) となります。子プロセスで exit を0以外の引数で呼び出せば，終了ステ 
ータスを0以外の値にセットすることができます。 

エラーの場合は， spawn …関数は-1を返し， errno に次のぃずれかの値をセ 
ットします。 

E2BIG 引数リストが長すぎる 

EINVAL 引数が正しくなぃ 

ENOENT パス名または ファ イル名が見つからなぃ 

ENOEXEC exec フォーマツ ト エラー 
ENOMEM メモリが不足した 

関連項目 abort , atexit . exit , exit , exec ..., fpreset , searchpath , system 

例/* SPAWNFAM.C: これを実行する限には，このあとの CHILD. C を 

• EXE ファイルにコンパイルしておいてください .*/ 

#include <8tdio.h> 

# include <process.h> 

8 tatu8(int val) 

{ 

if (val ― - 1 ) 

printf("failed to start child processVn*); 
else 

if (val > 0 ) printf("child terminated abnormally¥n*); 

> 

/* 次ページにつづく */ 
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main() 


I* 注意：以下の環塊文字列は 

実行するマシンに合わせて変更してください .*/ 

/* 環塊文字列を作成する */ 
char *envp( J - { •PATH-As¥¥* f 

• DUMMY-YES ■ f 

)； 

I* pathname を作成する */ 

char ^pathname - •C:¥¥CHILDREN¥¥CHILD.EXE •: 

/* 9i 败文字列を作成する */ 

char *args[] - { • CHILD.EXE" f «l8f t •2nd' NULL >; 

printf(■SPAWNL:¥n•>; 

status(spawnl(P_WAIT f pathname t args[0) t args 【 l 】， HULL)); 

printf(■¥nSPAWNV:¥n_): 

status(8pawnv(P_WAIT, pathname t arg8)); 

printf(■¥nSPAWNLE:¥n , ); 

status(spawnle(P_WAIT f pathname t args(0) f args[l] f NULL t envp ))； 
printf(■¥nSPAWNVPE:¥n »)5 

etatus(spawnvpe(P_WAIT f pathname f args f envp)); 


/* CHILD-C ••• SPAWHPAM.C のための子プロセス */ 

# include <8tdio.h> 

#include <8tdlib.h> 

main(int argc f char *argv[]) 

{ 

int i ； 

char *path f 食 dummy ； 

path _ getenvCPATH*); 
dummy - getenv(•DUMMY*)s 
for (i - 0 ； i < argc ； i++) 

printfrargv[Id] Zs¥n' i, argv[i ])； 
if (path) 

printfCPATH ■ 2s¥n B . path); 
if (dummy) 

printfCDUMMY - Zs¥n B f dunmy )； 
exit( 0) 5 /* 親プロセスにエラーコー KO を返す */ 
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sprintf 


機能 文字列に*式つき出力を害き込みます。 

形式 int sprintf (char * buffer 、 const char * format [ f argument ,,..]) : 

プロトタイプ stdio.h 

解脱 sprintf は， ybmia / によって指される害式文字列中の辨式指定を， format 

の後に統く各引数に適用し，密式化されたデータを文字列* ガ er に出力 

します。 

sprintf は，骹初の冉式指定を敢初の引数に， 2 つめの 瘠 式指定を 2 つめの引 
数に，というようにそれぞれ順番に適用していきます。書式指定は，後に 
統く引数と同じ数だけなければなりません。 

* buffer にそ の文字列を格納する充分な領域があるかどうか確認するの 
はブログラマの黄任です。 

#式指定を含む詳細な悄報については printf の解説を参照してください。 

戻り値 sprintf は，出力したバイト数を返します。このバイト数には，最後のヌル 

バイトは含まれません。 エラーの 場合は EOF を返します。 

可搬性 sprintf は UNIX システムで使用でき， ANSI C と互換性があります。 K & 

R でも定義されています。 

間連 項目 fprintf , printf 

例 printf を参照してください。 
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sqrt 

機能 正の平方根を計筠します。 

形式 # include く math . h 〉 

double sqrt (double x ) : 

プロトタイプ math.h 

解脱 sqrt は，入力値の正の平方根を計算します。 

戻り値 成功した場合， sqrt は，計算結果（ズの正の平方根）を返します。 

ズが負の値であった場合には0を返し， errm > に次の値をセットします。 

EDOM 定狻域 エラー 

可搬性 sqrt は UNIX システムで使用でき ， ANSI C と互換性があります。 

間連項目 exp , log ：, pow 
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srand 


機能 

形式 

プロトタイプ 

解脱 

戻り偭 
可撤性 
關連項目 


乱数発生ルーチンを初期化します。 
void srand (unsigned seed ) \ 
stdlib.h 


乱数発生ルーチンは，引数を 1 として srand を呼び出すことで初期化する 
ことができます。 seed に適当な値を指定して srand を呼び出せば，乱数発 
生の新たな開始点をセットすることができます。 

ありません。 

srand は UNIX システムで使用でき ， ANSI C と互換性があります。 

rand , random , randomize 
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sscanf 


機能 文字列をスキャンして宵式つき人力を行ないます。 

形式 int sscanf (const char 本 buffer 、 const char 本 format address ,...]) : 

プロトタイプ stdio.h 

解脱 sscanf は，一連の入カフィールドをスキャンして，一度に1文字ずつ文字列 

から文字を読み込みます。次に，引数 format によって指される游式文字列 
中の辦式指定にしたがって，各 フィ ー ル ドを齊式化します。最後に ， format 
の後に統く各引数が示しているアドレスに，辫式化した入力を格納してい 
きます。卉式文字列中の苒式指定の個数は，その後に統くアドレスの数と 
同じでなければなりません。 

冉式指定を含む詳細な悄報については scanf の解説を参照してください。 
sscanf は，いくつかの理由から，通常のフィールド終了文字（ホワイトス 
ベース）に達する前に，特定のフィールドのスキャンをやめたり，あるい 
は読み込み全体をやめてしまうことがあります。こうした問題については， 
scanf の解説を参照してください。 

戻り値 sscanf は，正しくスキャンし，変換し，格納した入カフィールドの数を返 

します。戻り値には，値を格納しなかった入カフィールドの数は含まれま 
せん。 

文字列の終わりを読み込んだ場合は，戻り値は EOF になります。 

値を格納したフィールドがなかった場合は，戻り値は0となります。 

可撤性 sscanf は UNIX システムで使用でき， ANSIC と互換性があります。 K & 

R でも定義されています。 

閣連項目 fscanf , scanf 
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stat 


機能 オーブンファイルに関する情報を得ます。 

形式 # include < sys ¥ stat . h > 

int stat (char 木 path ， struct stat 木 statbuf ) \ 


プロトタイプ sys ¥ stat.h 

解脱 stat は， p 似 A に指定されたオープンファイルまたはディレクトリに関する 

情報を stat 構造体の中に格納します。どちらの関数においても， 
statbuf は， stat 構造体 ( sys ¥ stat . h の中で定莪されている）を指していま 
す。 stat W 造体には次のようなフィールドが含まれています。 

st mode ファイルのモードに関する情報を与えるビットマスク 

st d ev そのファイルが»かれているディスクのドライブ番号 

st rdev st dev と同じ 

st nlink 整定数 1 にセット 

st size オーブンファイルの大きさ（バイト数） 

st_atime オーブンファイルの一番®:近修正された日時 

st mtime st atime と同じ 

st dime st atime と同じ 

stat 檐造体には，これ以外にフィールドが3つありますが， DOS では意味 
を持たないので省略します 〇ビッ トマスクはオーブンファイルのモードに 
関する情報を含んでおり，各ビットは次のような意味を持っていま 
す。 

次のビットのうち，いずれか1つがセットされます。 

S_IFREG path が通常ファイルを指定している場合 
S IFDIR path が rA レクトリを指定している場合 
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次の一方または両方のビットがセットされます。 


戻り値 


M 連項目 
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S_I WRITE ユーザが書き出し許可を得ている場合 
SJREAD ユーザが統み込み許可を得ている場合 

ビットマスクにはユーザ実行ビットも含まれています。これは，オーブン 
ファイルの拡張子にしたがってセットされます。ビットマスクには，さら 
に読み込み/冉き出しビットも含まれています。これらはファイルの許可モ 
ードにしたがってセットされます。 

stat そのオーブンファイルに関する悄報をうまく得られた場合は0を 

返します。エラーの場合は-1を返し， err / io に次の値をセットします。 

ENOENT パス名またはフアイル名が見つからない 

access , chmod , fstat , stat 
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_status87 


機能 

浮動小数点ステータスを得ます。 

形式 

unsigned int _ status 87 ( void ) : 

ブロトタイプ 

float.h 

解脱 

一 8 tatus 87 は，浮動小数点ステータスワードを取り出します。浮動小数点ス 
テータスワードは， 8087/80287 のステータスワードと 8087/80287 例外ハン 
ドラによって検出される他の条件を組み合わせたものです。 

戻り値 

戾り值 の各ビットが浮動小数点ステータスを示します。 status 87 が返す 
ビットの意味については float . h を参照してください。 

間連項目 

_ clear 87, contro !87, fDreset 

例 

jrontrol 87 を参照してください。 
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stime 


機能 

形式 

プロトタイプ 

解脱 

戻り値 
可撤性 

関連項目 
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時刻をセットする 

# include < time . h > 
int stime ( time 一 t * W : 

time.h 

stime は，システムの時刻と日付をセットします。 中は， GMT 1970 年1月 
1日の00 : 00 : 00から，設定する日付時刻までの経過秒数を表わす値を指し 
ます。 

stime は，成功した場合は0を返します。 
stime は UNIX システムで使用できます 0 

asctime , ftime f gettime , gmtime , localtime , ume f tzset 
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stpcpy 


機能 


j を他の文字列にコビーします。 


形式 


pcpy(char 本 dest , const char 本 src ) 



人® I 「 


，かこからゴ打/へコピーを行ないます。ヌル終了文字に出会った 
コピーをやめます。 

, dest + strlenU / r ) を返します。 


可撤性 


stpcpy は UNIX システムで使用できます。 


strcai 


機能 


ある文字列を他の文字列に付け加えます, 


形式 


char * strcat(char * dest , const char * src ) : 


プロトタイプ string.h 


解脱 


strcat は ， jrc のコピーを dest の 最後に付け加えます。得られる文字列の長 
さは, strlen ( dest ) + strlen ( src ) になります。 


戻り値 


strcat は，連結された文字列へのポインタを返します • 


可搬性 


strcat は UNIX システムで使用でき ， ANSI C と互換性があります。 K & 
R でも定義されています， 
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strchr 


機能 文字列を調べて，指定の文字が最初に現われる位置を探します。 

形式 char * strchr (const char + s t int c ) : 

プロトタイプ string.h 

解脱 strchr は，文字列を先頭から調べて，指定の文字を探します。 strchr は， 

文字列 s の中で最初に％われる文字 c を兒つけます。 

ヌル文字も文字列の一部と考えるので，たとえば次の呼び出しは， 

8 trchr (8 tr 8 , 0) 

文字列 J の敢後のヌル文字を指すポインタを返します。 

戻り 値 strchr は， J の中で最初に見つかった文字 c へのポインタを返します 0 

可搬性 strcat は UNIX システムで使用でき， ANSI C と互換性があります。 K & 

R でも定雜されています。 
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strcmp 

機能 ある文字列と他の文字列を比較します。 

形式 int strcmp (const char * sl t const char * s 2 ) : 

ブロトタイプ string.h 

解脱 strcmp は， j / と中の各文字を unsigned char として比較します。比較 

は各文字列の®:初の文字から始め，異なる文字が見つかるまで，あるいは 
文字列の終わりに達するまで絞けます。 

戻り値 strcmp は次のような他:を返します。 

<0 si が W より小さい 

==0 s / と W が等しい 
>0 W が W より大きい 

可搬性 strcmp は UNIX システムで使用でき ， ANSI C と互換性があります。 
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機能 文字ケースを区別せずに，2つの文字列を比較します。 


形式 # include く string . h 〉 

int strcmpi (const char * sl t const char 本 s 2 ). 

プロトタイブ string.h 

解脱 strcmpi は，文字ケース（大文字/小文字）を区別せずに， W と W 中の各 

文字を unsigned char として比較します。比較は各文字列の®初の文字か 
ら始め，異なる文字が見つかるまで，あるいは文字列の終わりに達するま 
で絞けます （ stricmp と同じですが， strcmpi はマクロです）。 
strcmpi は ， W (またはその一部）を W (またはその一部）と比較した結 
果に基づいて負，ゼロ，正の値を返します。 

strcmpi は stricmp と同じです 0 strcmpi は， string.h の中で stricmp の呼 

び出しに変換されるマクロとして定義されています。したがって ， strcmpi 
を使うときにはへッダフアイル string . h をインクルードしなければなりま 
せん。このマクロは他の C コンパイラとの互換性のために用意されていま 
す。 

戻り 値 strcmpi は次のような値を返します。 

<0 si が W より小さい 

==0 s / と W が等しい 
>0 si が W より大きい 

これら6つの関数は符号を考慮した比較を行ないます。 
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strcpy 


機能 ある文字列を他の文字列にコビーします。 

形式 char * strcpy (char * dest ， const char ■本 src ) : 

ブロトタイプ string.h 

解脱 strcpy は，文字列饥：をゴにコピーします 0 敢後のヌル文字をコビーし 

たところでコビーが終わります。 

戻り 値 strcpy は， tfes / を返します。 

可撤性 strcpy は UNIX システムで使用でき， ANSI C と互換性があります。 
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strcspn 


機能 

形式 

プロトタイプ 

解脱 

戻り値 

可搬性 
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文字列をスキャンし，指定の文字集合に含まれない文字のみからなる段初 
の部分を探します。 

# include く string . h 〉 

size t strcspn iconst char * s / 9 const char * s 2 ) : 


strmg.h 


strcspn は，文字列 j / を調べて，文字列 W に含まれていない文字のみから 
なる肢初の部分を見つけます。 


strcspn は， W 中の， d に含まれていない文字のみからなる®初の部分の 
技さを返します。 

strcspn は UNIX システムで使用でき ， ANSI C と互換性があります。 
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strdup 


機能 文字列を新たに作成した記係場所にコピーします。 

形式 char * strdup (const char * s ) : 

プロトタイプ string.h 

解脱 strdup は，文字列 s の梭製を作ります。複製を格納する領域は， malloc を 

呼び出して確保します。領域の大きさは （8 trlenU )+ l ) バイトです。 

戻り傕 strdup は，拔製された文字列が格納されている記悚場所を指すポインタを 

返します。記憶場所が確保できなかった場合は NULL を返します。 

可撤性 strdup は UNIX システムで使用できます。 

閱連項目 free 
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_strerror 


機能 エラーメッセージ文字列を指すボインタを返します。 

形式 char * strerror (const char * s ) : 

プロ トタイプ string.h, stdio.h 

解脱 strerror は，ユーザ#用のエラーメッセージを生成するための関数です。 

これは，ヌルで終わるエラーメッセージ文字列を指すボインタを返します。 

■ s が NULL の場合，戻り値には一番新しいシステムエラーメッセー 
ジが含まれています。この文字列はヌル文字で終わつています。 

■ J が NULL でない場合は，炅り値には s (ユーザ定義のメッセー 
ジ），コロン，空白，一番新しいシステムエラーメッセージ，改行文字 
が含まれています。 J の長さは94文字以下でなければなりません。 

Turbo C のバージョン 1.0 では， _strerror は strerror と同じものでした0 

戻り値 strerror は，エラーメッセージ文字列を指すポインタを返します0この文 

字列は狰的なバッファに格納されるので， _strerror を呼び出すたびに上 
辫きされます。 

関連項目 perror, strerror 
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strerror 


機能 エラーメッセージ文字列を指すポインタを返します。 

形式 char * strerror(int errnum ) : 

プロ トタイプ stdio . h , string.h 

解脱 strerror は，エラー番号び"?謂を引数にとり，これに対応するエラー メッ 

セージ文字列を指すポインタを返します。 

戻り値 strerror は，エラーメッセージ文字列を指すポインタを返します。この文 

字列は静的なハ•ッファに格納されるので， strerror を呼び出すたびに上讲 
きされます。 

可撤性 strerror は ANSI C と互換性があります。 

閬連項目 perror , strerror 
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stricmp 


機能 大文字小文字を区別せずに， 2つの 文字列を比較します。 

形式 int stricmp (const char 本 j /, const char ■本 ぷ2) : 


プロトタイプ string.h 


解脱 stricmp は，文字ケース（大文字/小文字）を区別せずに， W と W 中の各 

文字を unsigned char として比較します 0 比較は各文字列の最初の文字か 
ら始め，異なる文字が見つかるまで，あるいは文字列の終わりに達するま 
で統けます。 

stricmp は ， W (またはその一部）を W (またはその一部）と比較した結 
采に基づいて負，ゼロ，正の値を返します。 

stricmp は strcmpi と同じですが ， strcmpi は， string.h の中で stricmp の 

呼び出しに変換されるマクロとして定我されています。 

戻り値 stricmp は次のようなを返します。 


く〇 

si が d より小さい 

==0 

sf と s2 が等しい 

>0 

S/ が W より大きい 
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strlen 


機能 文字列の長さを計算します。 

形式 # include く string . h 〉 

size t strlen (const char * s ) : 

プロトタイプ string.h 

解脱 strlen は，文字列 J の長さを計算します。 

戻り 価 strlen は， s 中の文字の個数を返します。ヌル文字はカウントしません。 

可撤性 strlen は UNIX システムで使用でき ， ANSI C と互換性があります。 

strlwr 

檐能 文字列の中の大文字を小文字に変換します。 

形式 char * strlwr (char * s ) : 

プロトタイプ string.h 

解脱 strlwr は，文字列 5 の中の大文字 （ A 〜 Z ) を小文字 （ a 〜 z ) に変換しま 

す。英字以外の文字は変更されません。 

戻り 値 strlwr は，文字列 J へのポインタを返します 0 

関連項目 strupr 
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strncat 


機能 ある文字列の一部分を他の文字列に付け加えます。 

形式 # include く string . h 〉 

char * strncat (char 本 dest , const char 本 src , size t maxlen ) : 

プロトタイプ string.h 

解脱 strncat は， src の最大 m の:/⑼個の文字を，ゴ抓の終わりに付け加え，煅 

後にヌル文字を付加します 0 得られる文字列の長さの上限は， strlen 
( dest ) 十 maxlen になります。 

戻り値 strncat l ±, dest を返します。 

可撤性 strncat は UNIX システムで使用でき， ANSI C と互換性があります。 
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strncmp 


機能 ある文字列の一部分と他の文字列と比較します。 

形式 # include < string . h > 

int strncmp (const char * sl t const char 本 size t maxlen ) \ 


プロトタイプ string.h 

解脱 strncmp は， strcmp と同様に，文字列 W とジ中の各文字を unsigned 

char として比較します。比較は各文字列の最初の文字から始め，異なる文 
字が見つかるまで，または mtw :/ 伙個の文字を比較するまで，あるいは文字 
列の終わりに達するまで絞けます。 

strncmp は， W (またはその一部 ）を s 2 (またはその一部）と比較した結 
果に基づいて負，ゼロ，正の値を返します。 

戻り値 strncmp は次のような値を返します。 

く〇 *5/ が W より小さい 

==〇 5/と52が等しい 

>0 si がより大きい 

可撤性 strncmp は UNIX システムで使用でき， ANSI C と互換性があります。 
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strncmpi 


機能 ある文字列の一部分と他の文字列の一部分を，大文字小文字を区別せずに 

比較します。 

形式 # include く string . h 〉 

int strncmpi (const char * s /, const char * s 2 t size t n ) \ 

ブロトタイプ string.h 

解脱 strncmpi は，文字ケース（大文字/小文字）を区別せずに， W と中の最 

大《バイトの文字を unsigned char として比較します。比較は各文字列の 
肢初の文字から始め，異なる文字が見つかるまで，または/?個の文字を比 
铰するまで，あるいは文字列の終わりに達するまで絞けます ( strncmpi は 
strnicmp と同じですが， strncmpi は マクロ です）。 

strncmpi は，またはその一部）を W (またはその一部）と比較した結 
果に基づいて ft , ゼロ， 正の値を返します。 

strncmpi l ± strnicmp と同じですが , strncmpi は， string.h の中で strnic - 

mp の呼び出しに変換されるマクロとして定義されています。したがって， 
strncmpi を使うときには， へッ ダフアイル string . h をインクルードしなけ 
ればなりません。 

戻り値 strncmpi は次のような値を返します。 

<0 W が W より小さい場合 

==0 W と W が等しい場合 
>0 si が W より大きい場合 
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strncpy 


機能 

形式 

プロトタイプ 

解脱 

戻り値 

可撤性 


ある文字列の一部を他の文字列にコピーします。必要な場合には削除ある 
いはハ•ディングを行ないます。 

# include く stdio . h 〉 

char 木 strncpy、char 本 dest f const char 本 src , size t max ten ) : 


siring.h 


strncpy は，般大 maxlen 個の文字をぶ / r から dest にコ ピーします。畏すぎ 
れば削り，短かすぎればヌル文字を dest に埋めこみます。ゴ抓には， src の 
技さが maxlen 以上の場合は，妓後にヌル文字はつけられません。 

strncpy は， dest を返します。 

strncpy は UNIX システムで使用でき， ANSI C と互換性があります。 
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strnicmp 


機能 ある文字列の一部分と他の文字列の一部分を，大文字小文字を区別せずに 

比較します。 

形式 # include く string . h 〉 

int strnicmp (const char 本 s/，const char 本^2, size—t max ten ) : 

プロトタイプ string.h 

解脱 strnicmp は，文字ケース（大文字/小文字）を区別せずに， W と W 中の煅 

大 n バイトの文字を unsigned char として比較します。比較は各文字列の 
肢初の文字から始め，異なる文字が見つかるまで，または//個の文字を比 
較するまで，あるいは文字列の終わりに達するまで絞けます (strnicmp は 
strncmpi と同じですが， strncmpi は マクロ です)〇 

strnicmp は， W (またはその一部）を 5 2 (またはその一部）と比較した結 
果に基づいて負，ゼロ，正の値を返します。 

strncmpi は strnicmp と同じですが, strncmpi は， string.h の中で strnic - 

mp の呼び出しに変換されるマクロとして定栽されています。 

戻り値 strnicmp は次のような値を返します。 

く 0 si が d より小さい場合 

==0 W と d が等しい場合 
>0 J / が W より大きい場合 
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strnset 


機能 文字列中の指定個数の文字に指定の文字をセットします。 

形式 # include く string . h 〉 

char ホ strnset (char * 5 , int ch , size t n ). 


プロトタイプ string.h 


解脱 strnset は，文字列 s の先頭から八イトに文字 cA をコピーします。 

«> strlen (5) の場合， n は strlen (5) に S き換えられます 0 

コピーは，”文字をセットするまで，あるいはヌル文字が見つかるまで行な 

われます。 

戻り値 strnset は J を返します 0 
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strpbrk 


機能 文字列を調べて，指定した文字集合中の文字が最初に現われる場所を探し 

ます。 

形式 char 氺 strpbrk (const char 本 s /, const char 本 52) : 

プロトタイプ string.h 

解脱 strpbrk は，文字列を調べて，文字列 W に含まれるどれか1文字が嫒初 

に現われる位； S を探します。 

戻り値 strpbrk は， W 内の文字のどれかが肢初に現われる場所を指すポインタを 

返します。見つからない場合は NULL を返します。 

可搬性 strpbrk は UNIX システムで使用でき ， ANSI C と互換性があります。 
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strrchr 


機能 文字列を調べて，指定した文字が最後に現われる場所を探します。 

形式 char * strrchr (const char * s t int c )； 

プロトタイプ string.h 

解脱 strrchr は，文字列を終わりから逆方向に調べて，指定の文字を探します。 

strrchr は，文字列 s の中で最後に現われる文字 c * を見つけます。ヌル文字 
も文字列の一部と考えます。 

戻り値 strrchr は，文字でが骹後に现われる場所を指すポインタを返します。見つ 

からない場合は NULL を返します。 

可搬性 strrchr は UNIX システムで使用でき ， ANSI C と互換性があります。 

strrev 

機能 文字列を逆転させます。 

形式 char * strrev (char * s ) : 

ブロトタイプ string.h 

解説 strrev は，文字列 s の中のすべての文字を，最後のヌル文字は除いて逆順 

に並べ換えます（たとえば， string ¥0 は gnirts ¥0 になります）。 

戻り値 strrev は，逆順になった文字列を指すポインタを返します。 エラーの 戻り 

値はありません。 
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strset 

機能 文字列中のすべての文字を指定の文字に変更します0 

形式 char * strset (char * s 9 int ch ) : 

プロトタイプ string.h 

解脱 strset は，文字列 J の中のすべての文字に文字 cA をセットします。ヌル文 

字に出会ったところで終了します。 

戻り 値 strset は， J を返します。 

閬連項目 setmem 


422 


第2章 Turbo C ライブラリ 


strspn 


檐能 

形式 

プロトタイプ 

解脱 

戻り値 

可搬性 


文字列を調べて，指定の文字集合に含まれる文字のみからなる最初の部分 
を探します。 

# include < string . h > 

size t strspn (const char * 仏 const char * 5/) : 
string.h 

strspn は，文字列 W を調べて，文字列 d に含まれる文字のみからなる缎 
初の部分を探します。 

strspn は， W 中の， W に含まれる文字のみからなる敢初の部分の長さを返 
します。 

strspn は UNIX システムで使用でき， ANSI C と互換性があります。 
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strstr 


機能 文字列を調べて，指定の部分文字列が現われる場所を探します。 

形式 char * strstr (const char * s /, const char * s 2 ) : 

プロトタイブ string.h 

解脱 strstr は，文字列 W を調べて，部分文字列 W が最初に現われる位 S を探し 

ます。 

戻り値 strstr は， W を含む W 中の要素を指す U / 中の d を指す）ポインタを返 

します。 s 2 が si 中に存在しない場合は NULL を返します。 

可撤性 strstr は UNIX システムで使用でき， ANSI C と互換性があります。 
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strtod 


機能 文字列を double の値へ変換します。 

形式 # include < stdlib . h > 

double strtod (const char * s t char ホ* endptr ) : 


プロトタイプ stdlib.h 

解説 strtod は，文字列 s を double の値に変換します。 j が double の値として 

解釈されるためには，次のような形式になっていなければなりません。 


[ws)[sn J(ddd J[•][ddd)[fmt[sn]ddd) 


各部分は次のようになります。 

[邮] ホワイト スペース （なくてもよい) 

[ sn ] 符号 （+ または-，なくてもよい） 

[ ddd ] 数字の並び（なくてもよい） 

[ f ^ t ] e か E (なくてもよい） 

[•] 小数点（なくてもよい） 


strtod はさらに， + INF および- INF を，ブラス無限大およひ•マイナス無 
限大として認識します。また， + NAN および- NAN を非数 （ NotaNum - 
ber ) として解釈します。 

strtod で double に変換できる文字列は次のようなものです。 

+1231.1981 e -1 
502.85 E 2 
•2010.952 

strtod は， double の数値として解釈できなぃ文字があると読み込みをやめ 
ます。 e だ办びが NULL でなければ， endptr を， I 売み込みをやめた文字を指 
すよつにセットします （* endptr = dstopper) Q 
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戻り値 strtod (±, 5を変換した値を double として返します。オーバーフローが起 

きた場合は HUGE _ VAL を返します。 

可撤性 strtod は UNIX システムで使用でき ， ANSI C と互換性があります。 

問連項目 atof 
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strtok 


機能 文字列からトークンを次々に切り出します 0 トークンは2番目に指定した文 

字列の中に入っている文字によって区切られます。 

形式 char * strtok (char * si , const char * s 2)： 


プロトタイプ string.h 


解脱 strtok は，文字列は， W に含まれている文字（区切り子）によって区切 

られるトークンをいくつか含んでいるものと考えます。 
strtok を最初に呼び出すと， * s / 中の最初のトークンの先頭文字を指すボイ 
ンタを返し，返されたトークンの K 後にヌル文字を件きます。その後，肢 
初の引数として NULL を指定して strtok を速絞して呼び出すと ， strtok 
は， W にトークンがなくなるまで次のトークンを探していきます。 

区切り子文字列 W は，呼び出しごとに変化してもかまいません。 

戻り値 strtok は， 5 /中の見つかったトークンへのポインタを返します。それ以上 

トークンがない場合には NULL を返します。 

可搬性 strtok は UNIX システムで使用でき ， ANSI C と互換性があります。 


427 


例 


/* strtok - この例 *! は， strtok を使って日付を表す文字列を 
分します 0 形式の具なる日付 （ 12/3/87 ; Dec-12 ,1987 5 
January 15,1987 ; 12-FEB-87, etc.) を扱う場合，区切り 
文字の文字列には，必翬な文字（ピリオド，空白，カンマ， 
マイナスなど）を入れる必饜があります 0 
出力には区切り文字は含まれません。 

*i 

# include <stdio.h> 

# include <string*h> 


main () 

{ 

char *ptr 5 

ptr _ strtok (-FEB-14 ,1988* t ■. 
while (ptr I-HULL) 

{ 

printf (*ptr - ZsVn* f ptr )5 
ptr _ strtok (NULL, ••/■); 


プログラム出力 

ptr ■ FEB 
ptr ■14 
ptr _ 1988 
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strtol 


機能 文字列を long の値に変換します。 

形式 long strtol (const char * 5, char * * endptr , int radix ) : 

ブロトタイプ stdlib.h 

解脱 strtol は，文字列 5 を long の値に変換します。 j が | 0 n g の値として解釈さ 

れるためには，次のような形式になっていなければなりません。 

[w8](8nj[0)(x][ddd) 


各部分は次のようになリます。 

[ ws ] ホワイト スペース （なくてもよい） 

[ sn ] 符号 （+ または-,なくてもよい） 

[〇] ゼロ （なくてもよい） 

レ] x または X (なくてもよい） 

[ ddd ] 数字（なくてもよい） 

strtol は，認識できない文字のところで文字列を読むのをやめます。 
radix が2〜36の場合は， long 型整数は radix を基底として表現されます。 
radix が0の場合は， s の先頭の何文字かによって何進法であるかが決まり 
ます。 


最初の文字 

2番目の文字 

文字列 

0 

卜7 

8進表記 

0 

x または X 

16進表記 

卜9 


10進表記 
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radix が 1 の場合は，無効な値とみなされます。 radix が負あるいは36を越え 
る 場合は， エラーと なります。 

m 也として正しくない値を指定すると，結果は0となり，次の文字ポイン 
夕を開始文字列ポインタにセットします。 

5が8進数として解釈される場合は，〇〜7以外の文字は認識されません。 

■ s が10進数として解釈される場合は，〇〜9以外の文字は認識されません。 
j の値が他の数を基底とする数として解釈される場合は，数字と，その基底 
で使用される英字だけが認識されます。たとえば，基底が20のときは，〇〜9 
および A 〜 J が認識されます。 

戻り値 strtol は，文字列を変換した値を返します。エラーの場合は0を返します。 

可搬性 strtol は UNIX システムで使用でき ， ANSI C と互換性があります。 

関連項目 atoi , atol , strtoul 
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strtoul 


機能 文字列を unsigned long の値に変換します。 

形式 unsigned long strtoul (const char * s，char * * enaptr t int radix )； 


プロトタイプ stdlib.h 


解脱 strtoul は，文字列 s を unsigned long 型の値へ変換する以外は， strtol と 

同じです。詳細については strtol を参照してください。 

戻り値 strtoul は，変換した値を unsigned long で返します。エラーの場合は0を 

返します。 

可撤性 strtoul は ANSI C と互換性があります。 

関連項目 atol , strtol 
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strupr 


文字列中の小文字を大文字に変換します。 

、， char 本 strupr ^char * s) \ 

トタイブ string.h 

、, strupr は，文字列 s の中の小文字 （ a 〜 z ) を大文字 （ A 〜 Z ) に変換しま 

す。英字以外の文字は変更されません。 

値 strupr は， J を返します。 

項目 strlwr 
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swab 


機能 バイトを人れ替えます。 

形式 void swab^char * from ，char 本 ^?， int nbytes ) : 

ブロトタイプ stdlib.h 

解說 swab 1±,文字列/から文字列めへ， nbytes ハ•イトを コ ピーします。 こ 

のとき，隣り合う偶数位と奇数位逋のバイトが入れ替えられます。これ 
はバイトの並べ方が異なるマシンからの データを 処理する場合に便利です。 
nbytes は偶数でなければなりません。 

戻り値 ありません。 

可搬性 swab は UNIX システムで使用できます。 
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system 


機能 

形式 

プロトタイプ 

解脱 

戻り値 

可搬性 

M 連項目 
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DOS コマンドを実行します。 

int system ^const char * command ) \ 

stdlib.h, process.h 

system は， C ブログラムの中から， DOS の COMMAND.COM を呼び出し 
て，文字列 command で与えられた DOS コマンド，バッチファイルあるい 
は他のブログラムを実行します。 

実行されるブログラムは，カレントディレクトリか，環境変数 PATH にセ 
ットされているディレクトリに S かれていなければなりません。 
COMMAND.COM ファイルを探すために，環境変数 C 0 MSPEC が使われ 
ます。したがって， COMMAND.COM はカレントディレクトリに存在する 
必要はありません。 

system は，成功した場合は0,失敗した場合には -1 を返します。 

system は UNIX システムで使用でき， ANSI C と互換性があります。 K & 
R でも定務されています。 

exec ..., fpreset , searchpath , spawn ... 
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tan 


機能 

正接を求めます。 

形式 

# include く math.h> 


double tan (double x ) : 

プロトタイプ 

math.h 

解脱 

tan は，入力値の正接（タンジェント）を計算します。角度ズはラジアン 

単位で指定します。 

tan のエラー処理は，関数 matherr を使って変更することができます。 

戻り値 

tan は，ズの正接を返します。すべての有効な角度に対して値を返します 

が， -;r/2 や； r/2 に近い角度の場合は〇を返し， errno に次の値をセットし 

ます。 


ERANGE 値域ェラー 

可撤性 

tan は UNIX システムで使用でき， ANSI C と互換性があります。 

M 連項目 

acos, asm, atan, atan2, cos, cosh, sin, sinh, tanh 
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tanh 


機能 

形式 

ブロトタイプ 

解脱 

戻り値 
可搬性 
関連項目 
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双曲線正接を求めます。 

# include < math . h > 
double tanh (double x ) : 

math.h 

tanh は，実数引数の双曲線正接（ハイハ•ボリックタンジェント）を計算し 
ます。 

tanh のエラー処理は， matherr 関数を通して変更することができます。 
tanh は，ズの双曲線正接を返します 0 

tanh は UNIX システムで使用でき， ANSI C と互換性があります。 

acos , asm , atan , atan 2, cos , cosh , sin , sinh , tan 
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tell 


機能 ファイルポインタの現在位 S を得ます0 

形式 long telKint handle ) : 

プロトタイプ io.h 

解脱 teH は， handle に結ひ•つけられているフ了イ ルポインタの現在位*を将 

て，それをファイルの先頭からのバイト数として示します。 

戻り値 tell は，ファイルポインタの現在位置を返します。エラーの場合は -1 L を返 

し， errno に次の値をセットします。 

EBADF ファイル番号が正しくない 

可搬性 tell はすべての UNIX システムで使用できます。 

關連項目 fgetpos ， fseek , ftell , lseek 
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time 


檐能 

形式 

プロトタイプ 
解脱 

戻り値 

可搬性 

閬連項目 
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時刻を得ます。 

# include < time . h > 

time t time (time t « timer ) 

time.h 

time は， GMT (グリニッジ標準時刻）1970年1月1日の 00 : 00 : 00から現在 
までの経過時間を秒単位で与え，その値を " mer が指す記憶場所に格納し 
ます。 timer には， NULL でないポインタを与える必要があります。 

time は，上に述べた時刻を秒単位で返します。 

time は UNIX システムで使用でき ， ANSI C と互換性があります。 

asciime , ctime , difftime , ftime 9 getiime , g ： mtime , localtime , 
settime , stime , tzset 
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tmpfile 


機能 “スクラッチ”ファイルをバイナリモードでオーブンします。 

形式 # include < stdio . h > 

FILE * tmpfile ( void ) ; 


プロトタイプ stdio.h 


解脱 tmpfile は，テンポラリ（一時的）バイナリファイルを作成し，史新用（” 

w + 6”） としてオーブンします。このファイルは，クローズしたりブログラ 
ムが終了した時点で，自動的に削除されます。 

戻り値 tmpfile は，作成したテンボラリファイルのストリームを指すポインタを 

返します。ファイルを作成できなかった場合は NULL を返します。 

可搬性 tmpfile は UNIX システムで使用でき ， ANSI C と互換性があります。 


439 


tmpnam 


機能 ユニークなファイル名を作ります。 

形式 char * tmpnam (char + s ) : 

プロトタイプ stdio.h 

解脱 tmpnam はユニークなファイル名を作り出します。そのフアイル名はテン 

ボラリ（一時的）ファイルの名前として安全に使うことができます0 
tmpnam は，敢大 TMP MAX 回まで，呼び出すたびに異なる文字列を発 
生します。 TMP_MAX は， stdio.h の中で65535と定我されています。 
tmpnam の引数は， NULL か，肢低 L tmpnam flil の文字を要素に持つ配 
列へのポインタです。 L / mp/iam は stdio.h の中で定義されています。 s が 
NULL の場合, tmpnam は作成したテンポラリファイル名を内部の静的才 
ブジェクトに残し，それを指すボインタを返します。5 NULL でない場 
合は，テンポラリファイル名を J が指す配列の中に格納して J を返します。 

注意： tmpnam を使ってテンポラリファイルを作成した場合，そのファイ 
ルを削除するのはブログラマの貴任です（たとえば remove を呼び出す）〇 
そのファイルは自動的には消されません。 

戻り値 5が NULL の場合， tmpnam は内部の静的オブジェクトを指すポインタを 

返します。それ以外の場合は J を返します。 

可撤性 tmpnani は UNIX システムで使用でき， ANSI C と互換性があります。 
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toascii 


機能 

格数を ASCII 文字に変換します。 

形式 

mt toascii (int c ) : 

プロトタイプ 

ctype.h 

解脱 

toascii は，按数 c の下位 7 ビットをクリアして， ASCII 文字に変換するマ 
クロです。返される値の範囲は〇〜127になります。 


戻り侦 toascii は • r を変換した侦を返します。 

可搬性 toascii li UNIX システムで使用できます。 
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一 tolower 

機能 文字を小文字に変換します。 

形式 # include く ctype . h 〉 

int tolower (int ch ) \ 

ブロトタイプ ctype.h 

解脱 _ tolower は，整数 cA (範囲は EOF 〜 255) を小文字 （ a 〜 z ) の値に変換す 

るマクロです。これは， cA が大文字であるとわかっているときだけ使用す 
べきです。 

tolower は， tolower と同じ変換を行ないますが， tolower はマクロなの 
で，これを使うときには ctype . h をインクルードしなければなりません。 

戻り値 tolower li , ch が大文字の場合には変換した値を返します。そうでない場 

合の結果は未定我です。 

可撤性 tolower は UNIX システムで使用できます。 
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tolower 


機能 文字を小文字に変換します。 

形式 int tolower (int ch ) : 

ブロトタイプ ctype.h 

解説 tolower は，整数 cA (範囲は EOF 〜 255) を小文字 （ a 〜 z ) の値に変換す 

る関数です。 cA が大文字の場合にのみ変換が行なわれ，他の文字の場合は 
そのままです。 

戻り値 tolower は， cA が大文字の場合には変換した値を返します。そうでない場 

合には， cA をそのまま返します。 

可撤性 tolower は UNIX システムで使用でき ， ANSI C と互換性があります。 K & 

R でも定我されています。 
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一 toupper 

機能 文字を大文字に変換します。 

形式 # include <ctype.h> 

int toupper unt ch ) : 

プロトタイプ ctype.h 

解脱 toupper は，整数 cA を対応する大文字の値に変換するマクロです。これ 

は， ch が小文字であるとわかっているときだけ使用すべきです。 
toupper は toupper と同じ変換を行ないますが，これはマクロなので，使 
うときには ctype.h をインクルードしなければなりません0 

戻り値 toupper は， c/i が小文字の場合には変換した値を返します。そうでない場 

合の結果は未定義です。 

可搬性 toupper li UNIX システムで使用できます。 
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toupper 


機能 文字を大文字に変換します。 

形式 int toupper (int ch ) : 

プロトタイブ ctype.h 

解脱 toupper は，整数 cA (範囲は EOF 〜 255) を大文字 （ A 〜 Z ) の値に変換す 

る関数です。 cA が小文字の場合にのみ変換が行なわれ，他の文字の場合は 
そのままです。 

戻り値 toupper は， ch が小文字の場合には変換した値を返します。そうでない場 

合には， ch をそのまま返します。 

可搬性 toupper は UNIX システムで使用でき ， ANSI C と互換性があります。 K & 

R でも定我されています 9 
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tzset 


機能 グローバル変数 daylight , timezone , tzname の値をセットします 0 

形式 # include く time . h 〉 

void tzset ivoid )； 

プロトタイプ time.h 

解脱 tzset は，環境変数 TZ にしたがって， daylight ， timezone , tzname の 

3つのグローバル変数の値を セッ トします。ライブラリ関数 ftime と 
localtime は，地方時間带がどこであっても正しいグリニッチ標準時 
( GMT ) を得るために，この3つのグローバル変数を使用します。環境変 
数 TZ に設定される文字列の形式は以下の通りです。 

TZ - zz2(+/.]d[d][lll] 


zzz は現在の時間带の名前を表わす3文字の文字列です。3文字すベてが必要 
です。たとえば，文字列” PST ” は大平洋標準時 (Pacific Standard Time ) 
を表わすために使用されます。 

[+ハ]ゴ[ゴ]は，符号付きの1桁以上の数値を持つ必須のフィールドです（符 
号は正の値の場合には省略できます)。この数値は，その時間带と GMT と 
の差を示す時間数です。正の数の場合は GMT から西に，負の数の場合は 
GMT から束に向かって調整されます。たとえば，この数が5であれば 
EST ， +8ならば PST , イならヨーロッパ大陸というようになります。この 
数値は，グローハ V レ変数び mero / ie を計算する際に使われます 。 timezone 
は， GMT と地方時間带との差を秒単位で保持しています。 

///は，地方時間带夏時間を表わす省略可能なフィールドです。たとえば” 
PDT ” は，太平洋夏時間 (Pacific Daylight Savings Time ) を表わすため 
に使われます。このフィールドが存在すれば，グローパル変数 daylight は 
ゼロでない値にセットされることになります。 

環境変数 TZ が存在しないか，存在しても上記のような形式ではない場合， 
グローバル变数 daylight ， timezone , へ 代入するために，デフ ォ 
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ルトの TZ = ’’ EST 5 EDT ” が用いられます。 

グローバル 変数 tzname [0] lt . TZ 環境文字列から取り出した地方時間带 
名の3文字の文字列を指しています。 tzname [ l ] li , TZ 環境文字列から取 
リ出した地方時間带复時間名を表わす3文字の文字列を指しています。夏時 
間带名が無い場合には，加はヌル文字列を指します。 

戻り値 ありません。 

可撤性 tzset は UNIX および XENIX システムで使用できます 0 

参照項目 asctime ， ctime ， ftime , gmtime , localtime , stime，time 

例 #include <stdlib.h> 

#include <time.h> 

main() 

{ 

time 一 t td; 

putenvCTZ-PST8PDT*) 
tzset(); 
time(&td)$ 

printf(•Current time 


/* 太平洋夏崎間*/ 

卜 現在の_«/日付を得る*/ 

_ l8¥n* f a8Ctime(loc«ltime(J[td))) ; 
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ultoa 


機能 unsigned long を文字列に変換します。 

形式 char * ultoa (unsiged long value, char + string, int radix) : 

プロトタイプ stdlib.h 

解脱 ultoa は，阳 /we の値をヌルで終わる文字列に変換し，結果を功7>ぼに代入 

します 0 vfl/we は unsigned long 型です。 

⑺ゴかには， va / 於を変換する際に使用する基底を指定します。この値は 
2〜36の値でなければなりません c ultoa は，オーバーフローのチェックは 
行ないません。また， value が技で， radix が IQ であると， 負符号 （-) はセ 
ットされません。 

注意： w / 叩用に確保する領域は，返される文字列を格納するのに充分な 
大きさでなければなりません。 ultoa が返すのは©大33文字です。 

戻り値 ultoa は， string を返します。 エラーの戻り値はありません。 

閲連項目 itoa , ltoa 
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ungetc 


機能 入カストリームへ1文字をブッシュバックします。 


形式 # include く stdio . h 〉 

int ungetc (int c t FILE 木 stream ) \ 


プロトタイプ stdio.h 


解脱 ungetc は，入カストリームに 1 文字を返し（ブッシュバック）ま 

す。が/ • earn は入力用にオーブンされたものでなければなりません。この文 
字は，次に stream に対する getc あるいは fread の呼び出しによって返さ 
れます。文字1個は無条件でブッシュバックすることができます。 getc を呼 
び出さずに再ひ • ungetc を呼ひ•出すと，前にブッシュハ•ックした文字を消 
してしまうことになリます 0 fflush , fseek , fsetpos , あるいは rewind の呼 
び出しは，ブッシュバックされた文字のすべてのメモリを消去します。 

戻り値 ungetc は，成功した垛合はブッシュバックした文字を返し，操作に失敗し 

た場合は EOF を返します。 

可撤性 ungetc は UNIX システムで使用でき ， ANSI C と互換性があります 

閲連項目 fgetc ， getc , getchar 
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ungetch 


櫬能 

形式 

プ□トタイブ 

解脱 

戻り値 

可搬性 

関連項目 
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キーボードハ•ッファに1文字をブッシュバックします。 

int ungetch (int ch ) : 


conio.h 


ungetch は，コンソールに 1 文字をブッシュバックします。この文字は次の 
文字入力で說むことができます。 ungetch は，洸み込みをせずに2回以上統 
けて呼び出されるとエラーになります。 

ungetch は，成功した場合はブッシュバックした文字を返し，エラーの場 
合は EOF を返します。 


ungetch は UNIX システムで使用できます 0 


getch , geiche 
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unixtodos 


檐能 日付と時刻を DOS フォーマッ トに変換します。 


形式 # include < dos . h > 

void unixtodos (long time , struct date * d t struct time * t ) \ 

プロトタイプ dos.h 

解脱 unixtodos は， " me の中に与えられている UNIX 形式の時刻を DOS 形式 

に変換し，ゴおよび/が指している date および time 構造体を埋めます。 

戻り値 ありません。 

可搬性 unixtodos は MS - DOS に特有の関数です。 

M 連項目 dostounix 
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unlink 


機能 ファイルを削除します。 

形式 int unlink (const char ホ filename ) : 

プロ トタイプ dos . h ， io . h , stdio.h 

解脱 unlink は，で指定されたファイルを削除します。 Jilename には， 

DOS のドライブ名，パス名，ファイル名を使うことができます。ワイルド 
カードは使えません。 

挽み出し详用ファイルは， unlink の呼び出しでは削除できません。統み出 
し W 用ファイルを削除するには，先に chmod あるいは chmod を使って読 
み出し作用械性を変更しておく必、要があります。 

戻り値 unlink は，成功した場合は0を返します。エラーの壤合は-1を返し ， errno 

に次のいずれかをセットします。 

ENOENT パス名あるいはファイル名が見つからない 
EACCES アクセスが拒否された 

可搬性 unlink は UNIX システムで使用できます。 

関連項目 chmod , remove 
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unlock 


檐能 

形式 

プロトタイプ 

解脱 

戻り値 
可撤性 

閫連項目 


ファイルシェアリングロックを解きます〇 


int unlock (mt handle, long offset, long length) \ 


io.h 

unlock は， DOS 3 .ズのファイルシェアリング機能へのインターフェース 
を提供します。 

unlock は，以前の lock の呼び出しでセットされたロックを解除します。ェ 
ラーを避けるためには，ファイルをクローズする前にロックを解除してお 
かなければなりません。もちろん，ブログラムが終了する前にロックを解 
除しておかなくてはなりません。 

unlock は，成功した場合は0を返し，ェラーの場合は-1を返します。 

unlock は MS-DOS 3.ズに特有の関数です。これより前の八ージョンでは， 
この関数はサポートされません。 

lock , sopen 


453 





機能 可変個の引数リストを実現します。 

形式 # include く stdarg . h 〉 

void va start (va list par am , last fix ) \ 
type va _ arg(va list pa ram , type ) \ 
void va end ( va_list pa ram ) : 


プロトタイプ stdarg.h 

解脱 vfprintf , vprintf などのい〈つかの C 関数は，固定の引数リストに加え 

て，可変個の引数リストをとることができます。 va _. ••マクロは，こうし 
た引数リストをアクセスする可搬性のある方法を提供します。これらのマ 
クロは，呼び出された関数側では受け取った引数の個数と型がわからない 
場合に，引数リストを1つずつ進めて行くために使われます。 

ヘッダファイル stdarg . h では，1つの型 （va Hst ) と3つのマクロ (va start , 
va arg , va end ) が宣言されています。 

va list 

この配列は ， va arg と va end が必要とする情報を含んでいます。呼び 
出された関数が可変の引数リストをとるときは，その関数は vajist 型 
の変数 param を宣言します。 


va start 

このルーチン （マクロとしてインプリメントされています）は，その関 
数に渡される可変数の引数の先頭を param が指すようにセットします〇 
vastart は， vaarg や vaend が使用される前に使われなければなり 
ません 0 va start は2 つの 引数と last fix をとり ます （param につ 
いては上の va list を参照してください）。 lastfix は固定の引数リストの 
最後の引数の名前です。 
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vaarg 

このルーチン（これもマクロ）は，次に渡されるべき引数（可変引数の 
1つ）と同じ型，同じ値の式に展開されます。 va _ arg が最初に使用され 
ると，リストの最初の引数が返されます。 vaarg が使用されるごとに, 
リストの次の引数が返されます。これは，まず/^ mm を再参照し，その 
後/^ ram をインクリメントして次の項を指すようにします 。 va arg は， 
type を， デリファレンスと次の項の位 K づけに使います。以後 ， va arg 
が呼び出されるたびに，リスト中の次の引数を param が指すように変更 
します。 


va end 

このマクロは，呼び出された関数が通常のリターンを行なえるようにし 
ます 。 va end は/ warn を変更して ， va start が再び呼び出されなけれ 
ば使えないようにします 。 va arg ： がすべての引数を読み終わった後で， 
va end が呼ばれるようにすべきです。そうでない場合は，ブログラム中 
で何か予測できないことを引き起こす可能性があります。 


戻り値 va _ start と va end は値を返しません 。 va arg ： はリスト中の現在の引数 

{ param が指しているもの）を返します 0 

可搬性 va arg , va start , va end は UNIX システムで使用できます 0 

間連項目 v ... scanf , v...printf 
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/include <8tdio. 


#include <8tdarg.h> 

I* 0 で終わるリストの合針を求める */ 


void 8um(char *msg , …） 

( 

int total - 0; 
va—list ap ； 
int arg; 

va start(ap, msg); 
while ((arg ■ va_arg(ap f int)) !- 0) 
total +_ arg; 
printf(msg, total) : 


main() 

{ 

sumCThe total of 1+2+3+4 is Zd¥n* f l f 2 t 3 f 4 


プログラム出力 


The total of 1+2+3+4 is 10 



/include <stdio.h> 
linclude <8tdarg.h> 


void error(char 貪 format, •••> 

< 

va_li8t argptr; 

printf("errors •>; 
va_8tsrt(argptr, format); 
vprintf(format• argptr); 
va_end (argptr); 


main() 

{ 

int value _ -1; 

error("this is just an error messageVn"); 
error「invalid value Id encounteredVn 1 f value )5 


プログラム出力 


error:this is just an error message 
error：in valid value -1 encoutered 


0)； 
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vfprintf 


機能 ストリームに游式つき出力を冉き込みます。 

形式 # include く stdio . h 〉 

int vfprintf (FILE + stream 、const char * format % va list arglist ) \ 


プロトタイプ stdio.h 


解説 v ... printf 関数は，… printf 関数の別の エン トリポイントとして知られて 

います。これらは，対応する ... printf とほとんど同じように動作します 
が， v … printf 関数は，引数リストではなく，引数リストへのポインタを受 
け入れます。 

vfprintf は，引数の並びへのポインタ arglist を受け取り， / orm 如によって 
指される»式文字列中の苒式指定を各引数に適用して，辨式化されたデー 
夕を指定されたストリームに出力します。稗式指定の数は，引数と同じだ 
けなければなりません。 

卉式指定に関する詳細な悄報については， printf の解説を参照してくださ 


戻り値 vfprintf は，出力したバイト数を返します。エラーの場合は EOF を返しま 

す。 

可撤性 vfprintf は UNIX システム V で使用でき ， ANSI C と互換性があります。 

間連項目 printf , va ... 

例 printf を参照してください。 
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vfscanf 

機能 ストリームから書式つき入力を行ないます。 

形式 # include く stdio . h 〉 

int vfscanf (FILE * stream ，const char * jormat , va list arglist ) \ 

プロトタイプ stdio.h 

解脱 v ... scanf の関数は， ... scanf 関数への別の エン トリポイントとして知ら 

れています。これらは，対応する... scanf とほとんど同じように動作しま 
すが， v ... scanf 関数は，引数リストではなく，引数リストへのボインタを 
受け人れます。 

vfscanf は，一連の入カフィールドをスキャンして，一度に1文字ずつスト 
リームから文字を読み込みます。次に，引数/如によって指される#式 
文字列中の辦式指定にしたがって，各フィールドを# f 式化します。煅後に, 
arg / 加が指して いる リスト中の各アドレスに，拌式化した入力を格納して 
いきます。辩式文字列中の宵式指定の個数は， arglist が指すリスト中のア 
ドレスの数と同じでなければなりません。 

苒式指定も含めて，詳細な悄報 について は scanf の解説を参照してくださ 

い。 

vfscanf は，通常のフィールドの終了（ホワイトスペース）に達する前に, 
フィールドのスキャンをやめる場合があります。また，いくつかの理由か 
ら入力を終了してしまうこともあります。こうした問題については scanf 
の解説を参照してください。 

戻り値 vfscanf は，正しくスキャンし，変換し，格納した入カフィールドの数を返 

します。戻り値には，値を格納しなかった入カフィールドの数は含まれま 
せん0値を格納したフィールドがなかった場合は，戻り値は0になります。 

可撤性 vfscanf は UNIX システム V で使用できます。 

関連項目 fscanf , scanf，va ... 
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yprintf 


機能 

形式 

プロトタイプ 

解脱 


戻り価 

可搬性 

関連項目 

例 


stdout に 辯式つき出力を冉き出します 0 


# include く stdarg . h 〉 

int vprintf (const char ♦ format , va list arglist ) \ 


stdio.h 


v … printf 関数は，... printf 関数の別のエントリポイントとして知られて 
います。これらは，対応する ...printf とほとんど同じように動作します 
が， v... printf 関数は，引数リストではなく，引数リストへのポインタを受 
け入れます。 

vprintf は，引数の並びへのポインタ arg/iy/ を受け取り ， format によって 
指される供式文字列中の并式指定を各引数に適用して，書式化されたデ ー 
夕をがぬ如に出力します。并式指定の数は，引数と同じだけなければなり 
ません。 

#式指定に関する詳細な悄報については， printf の解説を参照してくださ 


vprintf は，出力したバイト数を返します。 エラーの 場合は EOF を返しま 
す。 

vprintf は UNIX システム V で使用でき， ANSI C と互換性があります。 




printf を参照してください。 
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vscanf 


機能 stdin から書式つき入力を行ないます。 

形式 int vscanf (const char * format , va list arglist ) \ 


プロトタイプ stdio.h 

解説 v...scanf の関数は， ...scanf 関数への別のエントリポイントとして知ら 

れています。これらは，対応する ...scanf とほとんど同じように動作しま 
すが， v … scanf 関数は，引数リストではなく，引数リストへのポインタを 
受け入れます。 

vscanf は，一速の入カフィールドをスキャンして，一度に1文字ずつがゴ/>? 
から文字を统み込みます。次に，引数 format によって指される冉式文字列 
中の冉式指定にしたがって，各フィールドを辦式化します。股後に ， arglist 
が指しているリスト中の各アドレスに，擀式化した入力を格納していきま 
す。斟式文字列中の#式指定の個数は， arglist が指すリスト中のアドレス 
の数と同じでなければなりません。 

丼式指定も含めて，詳細な情報については scanf の解説を参照してくださ 


戻り値 vscanf は，正しくスキャンし，変換し，格納した入カフィールドの数を返 

します。戻り値には，値を格納しなかった入カフィールドの数は含まれま 
せん。値を格納したフィールドがなかった場合は，戻り値は0になります。 

可撤性 vscanf は UNIX システム Vで使用できます。 

関連項目 fscanf, scanf, va ... 
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vsprintf 


機能 

形式 

ブロトタイプ 

解脱 


戻り値 

可撤性 
M 連項目 

例 


文字列へ辨式つき出力を害き込みます。 

int vsprintf (char 本 buffer 、 const char * format , va list artist ) : 


stdio.h 

v...printf 間数は，… printf 関数の別のエントリポイントとして知られて 
います。これらは，対応する ...printf とはとんど同じように動作します 
が， v … printf 関数は，引数リストではなく，引数リストへのポインタを受 
け入れます。 

vsprintf は，引数の並びへのポインタ arglist を受け取り，/ brma / によって 
指される丼式文字列中の冉式指定を各引数に適用して，»式化されたデー 
夕を文字列* に搿き込みます。冉式指定の数は，引数と同じだけな 

ければなりません。 

件式指定に関する詳細な情報については， printf の解説を参照してくださ 


vsprintf は，出力したパイト数を返します。エラーの場合は EOF を返しま 
す。 

vsprintf は UNIX システム V で使用でき， ANSI C と互換性があります。 



printf を参照してください。 
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vsscanf 


機能 文字列から害式つき入力を行ないます。 

形式 mt vsscanf (const char * bufjer , const cnar * format ， va list arglist ) : 

プロトタイプ stdio.h 

解脱 ucanf の関数は，.. . scanf 関数への別のエントリポイントとして知ら 

れています。これらは，対応する... scanf とほとんど同じように動作しま 
すが， v ...8 canf 関数は，引数リストではなく，引数リストへのポインタを 
受け入れます。 

vsscanf は，一連の入カフィールドをスキャンして，一度に1文字ずつ文字 
列* buffer から文字を読み込みます。次に，引数 format によって指される 
件式文字列中の»式指定にしたがって，各フィールドを黹式化します。® 
後に， arg / かが指しているリスト中の各アドレスに，害式化した入力を格 
納していきます。»式文字列中の害式指定の個数は， aa /扮が指すリスト 
中のアドレスの数と同じでなければなりません。 

擗式指定も含めて，詳細な悄報については scanf の解説を参照してくださ 


戻り値 vsscanf は，正しくスキャンし，変換し，格納した入カフィールドの数を返 

します。戻り値には，値を格納しなかった入カフィールドの数は含まれま 
せん。値を格納したフィールドがなかった場合は，戻り値は0になります。 
文字列の終わりを読み込んだ場合には EOF を返します。 

可撤性 vsscanf は UNIX システム V で使用できます。 

関連項目 fscanf , scanf , va ... 
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—write 


機能 ファイルへの害き込みを行ないます。 


形式 int write (int handle , void * buf ， unsigned ten ) \ 

プロトタイプ io.h 

解脱 write li , buf が指しているバッファから/⑼バイトを， handle に結びつ 

けられているファイルあるいはデバイスに冉き込みます。 handle は， 
creat ， open , dup , dup 2 の呼び出しで得られたファイルハンドルです。 
write によって# f き込めるのは最大65534バイトです。65535 ( OxFFFF ) 
は-1と同じであり，エラーを返すために使用されます。 
write が扱うファイルはすべてバイナリファイルなので，改行文字 ( LF ) 
を CR / LF に置き換えることはしません。 

実際に# f き込まれたバイト数が指定より小さい場合は，エラー（おそらく 
デイスクがいっぱいになった）を意味していると考えるべきです。 

デイスク上のファイルに対しては，»き込みは常にファイルボインタの現 
在位 S ( lseek を参照）から行なわれます。デバイスに対しては，そのデバ 
イスへバイトが直接送られます。 

OAPPEND オブシヨンでオーブンされたファイルに対して， write は， 
袢き込みの前にファイルポインタを EOF まで移動させません 0 

戻り値 _ write は，寿き込んだバイト数を返します。エラーの場合は-1を返し，グ 

ロー ハ•ル 変数 errno に次のいずれかを セッ トします。 

EACCES アクセスが否定された 

EBADF ファイル番号が正しくない 

可撤性 write は MS - DOS 特有のものです。 

閣連項目 lseek , read , write 
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write 


機能 ファイルに漭き込みを行ないます。 

形式 int write(int handle 、 void * buf ， unsigned len ) : 

プロトタイプ io.h 

解脱 write は，が指すバッファから / e /? バイトを， Aam / fc に結びつけられて 

いるファイルあるいはデバイスに叩き込みます。 handle は、 creat ， 
open ， dup , dup 2 の呼び出しで得られたファイルハンドルです。 

テキストファイルに苒き込みを行なうときには，ファイルに実際に冉き込 
まれるバイト数が指定した数を越えることがあります。 
write によって冉き込めるのは敢大65534バイトです。65535 ( OxFFFF ) は 
-1 と同じであり，これはエラーを返すために使用されます。 

テキストファイルでは，改行文字 （ LF ) があると， write は CR / LF に K 
き換えて出力します。 

実際に»き込まれたバイト数が指定より小さい場合は，エラー（おそらく 
デイスクがいつばいになった）を意味していると考えるべきです。 

デイスク上のファイルに対しては，辨き込みは常にファイルボインタの現 
在位 S ( lseek を参照）から行なわれます。デバイスに対しては，そのデバ 
イスへバイトが直接送られます。 

0_ APPEND オブ シヨ ンでオーブンされたファイルに対しては， write は， 
ファイルポインタを EOF まで移動してからデータを書き込みます。 

戻り値 write は，害き込んだバイト数を返します。テキストファイルに対する 

write では，生成された CR の数はカウントされません。 エラーの 場合は 
-1 を返し， errm > に次のいずれかを セツ トします。 

EACCES アクセスが否定された 

EBADF ファイル番号が正しくない 

可撤性 write は UNIX システムで使用できます。 
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関連項目 creat ， lseek , open , read , write 
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テキストビデオ関数リファレンス 


この節にまとめられているのは，テキストウィンドウの制御などを行なう関数です。こ 
れらは，その対象の機棟 （ PC -9801 シリーズ，あるいは IBM PC とその互換機）でしか 
動作しませんので注意してください。 

この節で解説しているルーチンのほかに，テキストウィンドウに対して入出力を行なう 
4つの関数， cprintf , cputs ， getche , putch があります。この 4 つについては，前の 
「Turbo C 標準間数リファレンス」を見てください。 


clreol 

機能 テキストウィンドウ内で，行末までを消去します。 

形式 void clreol ( void ) : 

プロトタイプ conio.h 

解脱 clreol は，カレントテキストウィンドウにおいて，カーソルの位 S から行末 

までのすベての文字を消去します。カーソルは移動しません。 

戻り値 ありません。 

可撤性 clreol は， PC -9801 シリーズ（または IBM PC とその互換機）でのみ動作 

します。 

関連項目 clrscr , delline，window 
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clrscr 


機能 

形式 

プロトタイプ 

解脱 

戻り値 
可搬性 

関連項目 


テキストウインドウをクリアします0 
void clrscr (void). 


conio.h 


clrscr は，カレントテキストウインドウをクリアし，カーソルをウインド 
ウの左上端 （ i , i ) に位置づけます。 

ありません。 

clrscr は， PC -9801 シリーズ（または IBM PC とその互換機）でのみ動作 
します。 


clreol delline , window 


テキストビデオ関数リファレンス 
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delline 


機能 テキストウィンドウ内で1行を削除します。 

形式 void delline ( void ) : 

ブロトタイプ conio.h 

解脱 delline は，カーソルがある行を削除し，その下にあるすベての行を1行上に 

ずらします。 delline は，現在アクティブなテキスト ウィン ドウに対して実 
行されます。 

戻り値 ありません。 

可撤性 deline は， PC -9801 シリーズ（または IBM PC とその互換機}でのみ動作 

します。 

関連項目 clreol . clrscr . insline , window 


468 


第2章 Turbo C ライブラリ 




gettext 


機能 テキストモード画面中のテキストをメモリに格納します。 

形式 int gettext (int lejt , int top , int right , int bottom 、 void * destin ) \ 

プロトタイプ conio.h 

解脱 gettext は，始点 ( Jeft 、 top 、 と終点 ( rightMttom ) で指定される画面上の 

長方形の内容を，引数 destin が指すメモリ上のバッファに格納します。 

4 つの座標は，すべて画面絶対座標で指定します（ウィンドウ相対座標では 
ありません）。画面の左上隅のセルが (1,1) です。 

gettext は，画面イメージデータを，左から右へ，また上から下へ順にバッ 
ファに格納していきます。 

PC -9801 では，格納領域み如のサイズ（八イト数）は次のようになり，煅 
低限これだけは確保することが必要です。 

モード 行数 桁数 厲性 

80 桁 (bottom — top + 1) X (right — left +1)X4 

40 桁 (bottom — top + 1) X (right — left -f 1) X 8 

面イメージと格納領域の関係は次のようになります。 

画面イメージ 



テキストビデオ関数リファレンス 
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■ 80 桁モードの場合： 


( bottom - top +1) 本 ( right - left -\-\) *4 バイト 


destin 

abBei : aaaaaa : AcdC aaaaaa ... 


i i 

—2 バイト 


—2 バイト 

6100 6200 4203 C 203 1 6500 6600 




(文字格納領域） （域性格納領域) 


■ 40 桁モードの場合： 


( bottom-top +1 )* ( right-left + 1)*8 バイト 


destin 

abBef ； 

aaaaaa 

AcdC aaaaaa ... | 




—2 バイト 






(文字.格納領域） 

—2 バイト 



1 


(« 性格納領域) 


E 1 :文字属性 xx :不定 

IBM PC では，画面上の1セルは，メモリ上では2バイトを占めます。第1バ 
イトがセル中の文字，第2ハ•イトがそのビデオ®性です。したがって，画面 
イメージに対して必要とされる格納領域のサイズは，桁数を vv , 行数を A 
とすると，次のようにして求めることができます。 

八イト数= Ax x 2 

戻り値 gettext は，成功したときは1を返します。エラーの場合（たとえば，カレ 

ントテキストモードで設定されている行数，桁数を越える範囲が指定され 
た場合など）には0を返します。 
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可搬性 

閫連項目 

例 


gettext は， PC -980 ：^U —《（ S 々 KIBMPC とその BIOS レベルの互換 
機）でのみ動作します。 

movetext，puttext 

/include <conio.h> 

main() 

{ 

char buf 【 20 食 10*2J5 

gettext(l f l f 20 t 10 t buf); 

/*•••*/ 

puttext(l f l f buf); 


/* UK の一部をセーブ */ 

/* ■ 面を回復 */ 


テキストビデオ関数リファレンス 
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gettextinfo 


テキストモードビデオ情報を得ます。 


形式 


# include < conio . h > 

void gettextimoistruct text info * r ) 


プロトタイプ conio.h 


解脱 


gettextinfo は，カレントビデオテキスト悄報を引数/■で指される梆造体 
text info に格納します。 

text info 構造体は，へッダファイル conio . h の中で次のように定義されて 
います。 


struct text 
unsigned 
unsigned 
unsigned 
unsigned 
unsigned 
unsigned 
unsigned 


•info { 

char winleft 5 
char vintop; 
char winright; 
char winbottom; 
char attribute ； 
char normattr; 
char currmode ； 


unsigned char screenheight 
unsigned char screenwidth; 
unsigned char curx; 
unsigned char cury; 


/* ウインドウの 左廑極*/ 
f* ウイン ドウの上 * 欏 */ 

/* ウインドウの右 * 極*/ 

/* ウインドウの 下廑棚*/ 

/* 現在の文字 属性*/ 

/* 遢 常の文字 属性*/ 

/* PC- 9801 では， 

VL/BG 8025,8020,4025,4020 
IBM PC では t 

BW80 t BW80 f C40 f C80 */ 

/* ■ 面の上限の高さ */ 

/* ■面の上限の 幅*/ 

I* カレントウインドウ中での X* 镖 
I* カレントウインドウ中での Y 座欏 


構造体のメンバ6价?んは現在表示している画面のページ番号で，ウィンド 
ウの大きさ，文字属性，カーソル情報はページ分あります。 


戻り値 


ありません。ただし結果は r が指している檐造体に格納されます< 


可搬性 


gettextinfo は， PC -9801 シリーズ（または IBM PC とその互換機）でのみ 
動作します。 
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wherey, window 


例 


#include <conio^h> 


void main() 

{ 

int bank; 

struct text info tinf; 

gettextinfo(4tinf); I* 現在の校定を得る */ 

if (tinf.currmode h 0x04) 

cpirintfClift グラフパターン有効モー K')5 

else 

cprintf (•バーチカルライン有効モー K'); 
if (tinf.currmode & 0x02) 
cprintf (MO 桁 X •); 
else 

cprintf(• 8 0 桁 X 
if (tinf•curmode & 0x01) 
cprintf (• 2 0 行 ¥r¥n ”； 

else 

cprintfC2 5 行 ¥r¥n*>; 

cprintf (•■面の高さ _2d _ • tinf • screenheight) 5 
cprintf (•■面の 幅 _Zd¥r¥n* • tinf. screemridth) 5 
bank - tinf •bank; 

cprintf (■ウィンドウの始点 （ Zd ， Zd) 終点 （ Zd,Zd) ¥r¥n*, 
tinf.winleft[bank 】， tinf.vintop[bank) f 
tinf.winright[bank] f tinf.winbottom(bank ])5 
cprintf (•现在の テキスト 表示 属性 - Z02X •, 
tinf.attribute 【 bank]); 
cprintf (• 省略 _ の テキスト 表示 J1 性 ■Z02X¥r¥n' 
tinf « normattr(bank ])5 
cprintf (•カーソル座欏 （ Zd.Zd) ¥r¥n* f 

tinf.curx[bank]• tinf•cury[bank)); 
if (tinf•cursor 【 bank] & 0x02) 
cprintf (•カーソル醇止中 •）； 

else 

cprintf (• カーソル点威中 •>; 
if (tinf•cursor[bank] & 0x01) 

cprintf (•カーソル裹示中 ¥r¥n 。； 

else 

cprintf (■カーソル消去中 ¥r¥n*>; 


テキストビデオ M 数リファレンス 
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gotoxy 


機能 

形式 

プロトタイプ 

解脱 

戻り値 
可搬性 

M 連項目 

例 
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テキストウィンドウ内のカーソルを位置づけます。 


void gotoxy(int ズ ， mt y ). 


conio.h 


gotoxy は，カレントテキストウィンドウの指定された位置にカーソルを 
動かします。座標が不適当な場合， gotoxy の呼び出しは無视されます〇た 
とえば， （35,25) がウィンドウの右下隅の座標であるのに， gotoxy (40.30) 
と呼び出すことは不可能です。 

ありません。 

gotoxy は， PC -9801 シリーズ（または IBM PC とその互換機）でのみ動作 
します。これに対応する関数は Turbo Pascal 4 . 0にもあります。 

wherex ， wherey , window 

gotoxy(10,20); I* カーソルを （ 10,20) に置く */ 
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highvideo 

機能 商輝•度文字を選択します。 

形式 void highvideo ( void ) : 

ブロトタイプ conio.h 

解脱 PC -9801 シリーズでは， highvideo はなんの動作もしないダミー関数です。 

IBM PC では high video は，現在選択されているフォアグラウンド色の商 
輝度ビットをセットすることによって，高輝度文字を選択します。 

この関数の呼び出しは，以降に呼び出される直接コンソール入出力関数 
(cprintf など）が出力する文字にのみ影锻を与えます。すでに画面に表示 
されている文字，および printf などの標準人出カストリームを使用する関 
数が出力する文字には影®を与えません。 

戻り値 ありません。 

可搬性 PC -9801 シリーズでは ， IBM PC との互換性のためにエントリだけが用意 

されています。 

IBM PC 版では ， IBM PC およびその互換機でのみ動作します。 

これに対応する関数は Turbo Pascal にもあります。 

関連項目 lowvideo , normvideo , textattr , textcolor 


テキストビデオ関数リファレンス 
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insline 


機能 

形式 

ブロトタイプ 

解脱 

戻り値 

可撤性 

関連項目 
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テキストウィンドウ内で空行を挿入します。 
void insline ( void ) : 

conio.h 

insline は，テキストウィンドウ内の力ーソルがある位;»に空行を揷人しま 
す。空行の下にある行はすべて1行下がり，骹下行はウィンドウの下に消え 
ます。 

IBM PC では，挿入される行には現在のバックグラウンド色が用いられま 
す。 

insline は，テキストモードで使用されます。 

ありません。 

insline は， PC -9801 シリーズ（または IBM PC とその互換機）でのみ動作 
します。これに対応する関数は Turbo Pascal 4.0 にもあります。 

delline , window 
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lowvideo 


機能 

形式 

プロトタイプ 

解説 


戻り価 
可搬性 

関連項目 


低輝度文字を選択します。 
void lowvideo ( void ) : 


conio.n 


PC -9801 シリーズでは， lowvideo は何の動作もしないダミー関数です。 


IBM PC では lowvideo は，現在選択されているフォアグラウンド色の商 
輝度ビットをクリアすることによって，低輝度文字を選択します。 

この関数の呼ひ•出しは，以降に呼ひ•出される直接コンソール入出力関数 
(cprintf など）が出力する文字にのみ影®を与えます。すでに闽面に表示 
されている文字，および printf などの標準入出カストリームを使用する関 
数が出力する文字には彩饗を与えません。 

ありません。 

PC -9801 シリーズでは， IBM PC との互換性のためにエントリだけが用意 
されています。 

IBM PC 版では， IBM PC およひ•その互換機でのみ動作します。 

これに対応する関数は Turbo Pascal にもあります。 

hi 於 hvideo , normvideo , texiattr , textcolor 


テキストビデオ関数リファレンス 
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movetext 


機能 

形式 

プロトタイプ 

解脱 


戻り値 

可撤性 

M 連項目 


画面上のテキスト領域を別の領域にコピーします。 

int movetext (int left，mt top , int right , int bottom ， 

int destleft , int desttop ) \ 


conio.h 

movetext は，/ e //， 叫 7, right , bottom で定我される画面上の長方形領域の 
内容を，同じ形の別の領域にコピーします。コピー先のブロックの左上隅 
の位逋は ( destleft , desttop ) で与えられます。 

すべての座標は画面上の絶対座標で表わします。2つの領域がオーバーラッ 

ブしてぃる場合にも，正しくコピーが行なわれます。 

movetext は，度接ビデオ出力を行なうテキストモード関数です。 

movetext は，コビーが成功したときに0以外の値を返し，コピーに失敗し 
たとき（現在の画面モードの範囲を越える座標を指定したときなど）には 
0を返します。 

movetext は， PC -9801 シリーズ（または IBM PC とその BIOS レベルの互 
換機）でのみ動作します。 

gettext , puttext 

/* 左上隈（ 5,15), 右下飄 （ 20,25) の領域を， 

新しい左上隔 （ 10,20 ) にコビーする */ 

movetext(5 f 15 f 20, 25 f 10 t 20); 


例 



normvideo 


機能 

形式 

プロトタイプ 

解脱 

戻り偭 
可撤性 

関連項目 


_面の表示属性をデフオルトに戻します。 
void normvideo ( void ). 


conio.h 


normvideo は，画面の表示属性の設定を（ブログラムが実行を開始したと 
きの）デフォルトの状態に戻します。デフォルトの状態は，構造体 text 
info の normattr にセットされているものです （ gettextinfo を参照）〇 
この関数の呼び出しは，以降に呼び出される直接コンソール入出力関数 
( cprintf など）が出力する文字にのみ影響を与えます。すでに画面に表示 
されている文字，および printf などの標準入出カストリームを使用する関 
数が出力する文字には衫響を与えません。 


ありません。 


normvideo は， PC -9801 シリーズ（または IBM PC とその互換機）でのみ 
動作します。これに対応する関数は Turbo Pascal にもあります。 

hitrhvideo , lowvideo , textattr , textcolor 


テキストビデオ 関数 リファレンス 


479 


puttext 


機能 メモリから画面上にテキストをコピーします。 

形式 int puttext(int left , int top , int right , int bottom , void * source ) : 

ブロトタイプ conio.h 


解脱 puttext は， gettext によつて格納された source が指すメモリ領域の内容 

を，始点 ( leftjop ) と終点 ( right ， bottom 、 で指定される画面上の長方形に 
復元します。 

座標はすべて，_面絶対座標で指定します（ウィンドウ相対座標ではあり 
ません）。画面の左上隅が (1,1) です。 

puttext は，メモリ領域の先頭から画面上の長方形領域へ，左から右へ，ま 
た上から下へ順にテキストを復元します。 

戻り値 puttext は，成功したときは0以外の値を返します。エラーがあつた場合（た 

とえば，カレントテキストモードで設定されている行数，桁数を越える範 
囲が指定されたときなど）には0を返します。 

可搬性 puttext は， PC -9801 シリーズ（または IBM PC とその BIOS レベルの互換 

機）でのみ動作します。 

閲連項目 gettext , movetext , window 
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textattr (PC-9801) 


機能 テキスト属性をセットします。 

形式 void textattr(int newattr ) : 

プロトタイブ conio.h 


解説 textattr は，1回の呼び出しで文字の色，縦線の有無，下線の有無，反転の 

指示，点滅の指示などの W 性を設定することができます。 

この関数の呼び出しは，以降に呼び出される直接コンソール入出力関数 
( cprintf など）が出力する文字にのみ影響を与えます。すでに|由」面に表示 
されている文字，およひ — printf などの標咿入出カストリームを使用する関 
数が出力する文字には衫#を与えません。 

引数 newattr の各ビットの意味は次のようになっています。 



G 緑の発色 （1 のとき有効） 

R 赤の発色 （1 のとき有効） 

B 宵の発色 （1 のとき有効> 

VLBG textmode で VLata : ズズモードが指定されている場合には 

縦郛線添付の指示を意味し， BG ズズズズモードが指定されて 
いる場合にはグラフ イッ ク文字の表示の指示を意味します 
(1 のとき有効)。 

UL 下線添付の指示 （1 のとき有効） 

RV 反転表示の指示 （1 のとき有効） 

BK 点滅表示の指示 （1 のとき有効） 

SC 隐し表示の指示（〇のとき有効） 


テキストビデオ閭数リファレンス 
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ヘッダファイル conio . h 内には下記のように城性が定義されています。 


定数名 

値 

意味 

T 一 BLACK 

0 x 00 

黑 

T—BLUE 

0 x 20 

青 

TGREEN 

0 x 80 

緑 

T 一 CYAN 

OxAO 

水色 

T_RED 

0 x 40 

赤 

TMAGENTA 

0 x 60 

紫 

T-BROWN 

OxCO 

黄色 （ T _ YELLOW と同じ） 

TLIGHTGRAY 

OxEO 

白 （ T _ WHITE と同じ） 

TDARKGRAY 

0 x 00 

黑 （ T _ BLACK と同じ） 

T—LIGHTBLUE 

0 x 20 

靑 （ T _ BLUE と同じ） 

T LIGHTGREEN 

0 x 80 

緑 ( T _ GREEN と同じ） 

TLIGHTCYAN 

OxAO 

水色 （ T _ CYAN と同じ） 

TLIGHTRED 

0 x 40 

赤 （ T _ RED と同じ） 

T 一 LIGHTMAGENTA 

0 x 60 

紫 ( T _ MAGENTA と同じ） 

TYELLOW 

OxCO 

黄色 

TWHITE 

OxEO 

白 

VERTICALLINE 

0 x 10 

縦線の添付 

NOVERTICALLINE 

0 x 00 


UNDERLINE 

0 x 08 

下線の添付 

NOUNDERLINE 

0 x 00 


REVERSE 

0 x 04 

反転表示 

NOREVERSE 

0 x 00 


BLINK 

0 x 02 

点滅表示 

NOBLINK 

0 x 00 


SECRET 

0 x 00 


NOSECRET 

0 x 01 

隠し域性の否定 

BASICGRAPH 

0 x 10 

グラフイック文字の指示 

NOBASICGRAPH 

0 x 00 
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戻り値 


ありません。 


可搬性 textattr は PC -9801 シリーズでのみ動作します。 

間連項目 gettextinfo , normvideo , textcolor 


例 


linclude <conio.h> 
main() 

{ 

textmode (VL8025 )5 /* 対象のモード */ 

textattr(CYAN | REVERSE | NOSECRET 〉； 

/* 水色 • 反転展性 */ 

/*•••*/ 

textattr(CRED | REVERSE | BLINK 1 NOSECRET); 

/* 赤色 • 反転 • 点滅属性 */ 


テキストビデオ閧数リファレンス 
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textattr (IBM PC) 


機能 テキスト属性をセットします。 

形式 void textattr(int newattr ) : 

ブロトタイプ conio.h 

解脱 textattr は，1回の呼び出しでフォアグラウンドと八ックグラウンドの闽 

方の色をセットすることができます （ textattr を使わない場合には，これ 

らの铋性は，それぞれ textcolor および textback ^ round によってセット 
します)。 

この関数の呼び出しは，以降に呼び出される直接コンソール人出力関数 
( cprintf など）が出力する文字にのみ影猓を与えます。すでに_面に表示 
されている文字，および printf などの標準入出カストリームを使用する関 
数が出力する文字には彩®を与えません。 

引数/? evwmr の各ビットの意味（色悄報）は次のようになっています。 



ffff この4ビットでフォアグラウンド色を表わします （0 〜15)。 

bbb この3ビットでバックグラウンド色を表わします （0 〜8)。 

B ブリンク（点滅）指定ビットです。 

ブリンク指定ビットがオンのときには，文字が点滅します。これは，域性 
値に定数 BLINK を加えることによって指定することができます。 

呢咖价に指定する値には， conio . h の中で定我されているシンボリック定 
数を使用することができます。バックグラウンド色の指定に関しては次の 
ような制限があることに注意してください。 

■バックグラウンド色には，前半の8色しか選択できません。 

■バックグラウンド色は，定数値を左に4ビットシフトすることによって 
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正しいビット位菡が得られます（例を参照してください）。 


定数名 値 フォア/バック 


BLACK 

0 

BLUE 

1 

GREEN 

2 

CYAN 

3 

RED 

4 

MAGENTA 

5 

BROWN 

6 

LIGHTGRAY 

7 

DARKGRAY 

8 

LIGHTBLUE 

9 

LIGHTGREEN 

10 

LIGHTCYAN 

11 

LIGHTRED 

12 

LIGHTMAGENTA 

13 

YELLOW 

14 

WHITE 

15 

BLINK 

128 


両方 
両方 
№5方 
両方 
難 
両方 
両方 
両方 

フォアグラウンドのみ 
フォアグラウンドのみ 
フォアグラウンドのみ 
フォアグラウンドのみ 
フォアグラウンドのみ 
フォアグラウンドのみ 
フォアグラウンドのみ 
フォアグラウンドのみ 
フォアグラウンドのみ 


戻り値 ありません。 

可撤性 textattr は IBM PC とその互換機でのみ動作します。 

間連項目 gettextinfo ， highvideo, lowvideo, normvideo, textbackground, 

textcolor 

例 /* バックグラウンドに青，文字に点滅の黄色を選択する*/ 

textattr (YELLOW + (BLUE«4) + BLINK); 
cputs(■Hello, world *)； 


テキストビデオ関数リファレンス 
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textbackground 


機能 文字のバックグラウンド色をセットします0 

形式 void textbackground unt newcolor ) : 


プロトタイプ conio.h 

解脱 PC -9801 シリーズでは， textbackground は何の動作もしないダミー関数 

です。 


IBM PC では， textbackground はバックグラウンドテキスト色を選択し 
ます。 

この関数の呼び出し以降に，迸接ビデオ出力を行なうテキストモード関数 
によつて冉かれるすべての文字のバックグラウンドは， newcolor で与えら 
れた色になります。 wewcoter に指定するのは〇〜7の按数です。 
textbackground を呼び出した時点で表示されている文字には影®を与え 
ません。 

wevvcofar に指定できる色（シンボリック定数または数値）は次の通りで 
す。 


定数名 

値 

BLACK 

0 

BLUE 

1 

GREEN 

2 

CYAN 

3 

RED 

4 

MAGENTA 

5 

BROWN 

6 

LIGHTGRAY 

7 
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戻り値 

可撤性 

関連項目 

例 


ありません。 

textbackground は， PC 9801 シリーズでは IBM PC との互換性のために 
エントリのみが用意されています。 

IBM PC では， textbackground は IBM PC あるいはその互換機でのみ動 
作します。これに対応する関数は Turbo Pascal 4.0 にもあります。 

gettextinfo , textattr , textcolor 

/* バックグうウンドを素にする*/ 
textbackground (MAGENTA) ; 


テキストビデオ M 数リファレンス 
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textbank (PC- 9801 のみ ) 


機能 

形式 

ブロトタイブ 

解脱 


戻り値 

可撤性 
間連項目 

例 


488 


画面ページを切り換えます。 


void textbank (int bank ) \ 


conio.h 

textbank は，画面ページの切り換えを行ないます。引数には0または 
1を指定してください。 

2つの画面ページにはそれぞれ別々に，ウィンドウ，文字域性，カーソル位 
菡の«性をセットすることができます。ただし，テキストモードは同じも 
のになります。 

注意： PC -9801 の®初期型，および PC -9801 U 2 には圃面ページは1枚しかな 
い（テキスト VRAM が1園面分しかない）ので，ページ1を使用することは 
できません。 


ありません。 

textbank は， PC -9801 でのみ觔作します 0 


textmode 


/include < conio . h > 
void main () 




textbank ( l )； 




cprintf (•ページ 1 
textbank ( O ); 


を表示しました 0 ¥ r ¥ n _); 



textcolor(GREEN); 

cprintfC ページ〇を裹示しました。 ¥ r ¥ n ») 5 
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textblink (PC-9801 のみ ) 


機能 

文字の点滅域性をセットします。 

形式 

void textblink (int blink ) : 

プロトタイプ 

conio.h 

解脱 

textblink は，文字の点滅属性をセットします。 弓傲 blink には, conio.h さ 
れているシンボリック定数 BLINK (0 x 02) または NOBLINK (0 x 00) 指定 
します。 

この関数の呼び出しは，以降に呼び出される直接 コン ソール入出力関数 
(cprintf など）の文字に衫響を与えます。 

戻り値 

ありません。 

可撤性 

textblink は， PC-9801 シリーズでのみ動作します。 

閭連項目 

textattr 

例 

# include < conio * h > 
void main () 

{ 

textblink ( BLIHK)5 /* 点滅を！ ^定 */ 

cpxrint f (•点滅 表示 ¥ r ¥ n-) 5 

textblink ( HOBLINK ) 5 /* 点滅を __ */ 


テキストビデオ 閫数 リファレンス 
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textcolor (PC-9801) 

機能 文字の色属性をセットします。 

形式 # include く conio . h 〉 

void textcolor (int newcolor )； 

プロトタイプ conio.h 

解脱 textcolor は，文字の色属性をセットします 0 

この関数の呼び出しは，以降に呼び出される直接コンソール入出力関数 
(cprintf など）が出力する文字にのみ影®を与えます。すでに_面に表示 
されている文字，および printf などの樣準入出カストリームを使用する関 
数が出力する文字には影®を与えません。 

newcolor には， conio . h に定我されている以下のシンボリック定数（あるい 
はその値）を指定します。 


定数名 

値 

意味 

T—BLACK 

0 x 00 

黑 

T 一 BLUE 

0 x 20 

宵 

T GREEN 

0 x 80 

緑 

T 一 CYAN 

OxAO 

水色 

TRED 

0 x 40 

赤 

T MAGENTA 

0 x 60 

紫 

T 一 BROWN 

OxCO 

黄色 （ T _ YELLOW と同じ） 

T_LIGHTGRAY 

OxEO 

白 （T WHITE と同じ） 

TDARKGRAY 

0 x 00 

黑 （ T _ BLACK と同じ） 

T 一 LIGHTBLUE 

0 x 20 

青 （ T _ BLUE と同じ） 

TLIGHTGREEN 

0 x 80 

緑 （ T _ GREEN と同じ） 

TLIGHTCYAN 

OxAO 

水色 （ T _ CYAN と同じ） 

T LIGHTRED 

0 x 40 

赤 （T RED と同じ） 
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T LIGHTMAGENTA 0 x 60 紫 （ T—MAGENTA と同じ) 

T YELLOW OxCO 黄色 


T WHITE OxEO 白 


戻り値 ありません。 

可撤性 textcolor は PC -9801 シリーズでのみ動作します。これに対応する関数が 

Turbo Pascal にもあります。 

閬連項目 gettextinfo , normvideo , textattr，textbackground 


テキストビデオ関数リファレンス 
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textcolor (IBM PC) 


機能 テキストモードでの文字色を選択します。 

形式 # include く conio . h 〉 

void textcolor (int newcolor ) : 

ブロトタイプ conio.h 

解脱 textcolor は，フォアグラウンドの文字色を選択します。以降にコンソール 

出力関数によって害かれるすべての文字のフォアグラウンド色は，狀ゅ 
に与えられた色になります。 newco / or には， conio . h で定義されてい 
るシンボリック定数を使用することができます。シンボリック定数を使う 
場合には， conio . h をインクルードしなければなりません。 

この関数の呼び出しは，以降に呼び出される直接コンソール人出力関数 
( cprintf など）が表示する文字にのみ影®を与えます。 textcolor が呼び 
出された時点で表示されている文字には彩®を与えません。また ， printf 
などの樣準入出カストリームを使用する関数には衫簪しません。 

次に示したのは，フォアグラウンドに使用できる色（シンボリック定数） 
およびその値です。 


定数名 

値 

定数名 

値 

BLACK 

0 

DARKGRAY 

8 

BLUE 

1 

LIGHTBLUE 

9 

GREEN 

2 

LIGHTGREEN 

10 

CYAN 

3 

LIGHTCYAN 

11 

RED 

4 

LIGHTRED 

12 

MAGENTA 

5 

LIGHTMAGENTA 

13 

BROWN 

6 

YELLOW 

14 

LIGHTGRAY 

7 

WHITE 

15 



BLINK 

128 
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文字をブリンク（点滅）させたいときには，フォアグラウンド色に128を加 
えます。これには 定義 済みの 定数 BLINK を使うことができます。たとえ 
ば次のようにします。 


textcolor(CYAN + BLINK )； 


注意：モニタの神•類によっては，8つの明るい色 (8-15) を作るために用 
いられる商輝度信号が認識されないことがあります。このようなモニタで 
は，明るい色は暗い色 （0 〜 7) とまったく同じ色になります。また，シス 
テムによってはこれらの数値を色の違いではなく，单色の階調，特殊なパ 
ターン，あるいは特別な®性（下線，ボールド，イタリック，など）で表 
現するものもあります。こうしたシステムで，色の指定が実際に画面にど 
のように表示されるかはハードウヱアに依存します。 

戻り値 ありません。 

可搬性 textcolor は， IBM PC およびその互換機でのみ動作します。これに対応す 

る関数が Turbo Pascal にもあります。 

間連項目 gettextinfo , hig ： hvideo , lowvideo , normvideo , textattr , 

textbackg：round 


テキストビデオ関数リファレンス 
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textcursor (PC-9801 のみ ) 


機能 

形式 

プロトタイプ 

解脱 


戻り値 
可撤性 
例 


カーソルの 域性を設定します〇 


void textcursor (int cursor ) • 


conio.h 

textcursor は，カーソル； K 性を設定します。カーソルの表示または非表示 
の指定，カーソルの静止表示または点滅表示の指定を行ないます。 

引数 cwr 如 r には，へッダフアイル conio.h で定義されているシンボリック 
定数を指定することができます。 


定数名 

値 

意味 

DISP 一 CURSOR 

0 x 01 

カーソル 表示 

NODISP_CURSOR 

0 x 00 

カーソル 非表示 

BLINK 一 CURSOR 

0 x 00 

カーソル 点滅表示 

NOBLINK—CURSOR 

0 x 02 

カーソル静止 表示 


ありません。 


PC -9801 シリーズでのみ動作します。 


# include <conio.n> 
void main() 

{ 

textcursor(DISP 一 CURSOR | BLINK 一 CURSOR>; 

~ 7 * 力ーソル点滅表示 */ 

textcursor(DISP 一 CURSOR | HOBLIHK_CURSOR)5 

_ /* カーソル靜止表示 */ 

textcursor(HODISP CURSOR) /* カーソル穽裹示 */ 
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textmode (PC-9801) 


機能 テキストモードを設定します。 

形式 void textmode (mt newmode ) \ 

ブロトタイプ conio.h 

解脱 textmode は，引数 newmode で指定されたテキストモードを設定します 0 

目的とするテキストモードは， conio . h に定義されている列挙型似 r 
modes の中のシンボリック定数によつて指定することができます。シンボ 
リック定数を使用する場合には， conio . h をインクルードしなければなり 
ません。 

テキストモードはページごとに異なるモードを設定することはできません 
(textbank を参照)。また，この関数で設定を行なわずに表示関数を使用 
したとき，桁数と行数，縦界線の有無，および文字の色属性は，ブログラ 
ムを起動したときに設定されていた状態と同じものになります。 
text 型の定数，数値，および設定されるモードは以下の通りです 0 


定数名 

値 

テキスト モー 

.K 

LASTMODE 

-1 

直前に設定したテキストモード 

VL 8025 

0 

80桁 x 25行， 

縦释線が有効 

VL 8020 

1 

80桁 x 20行， 

縦 E 線が有効 

VL 4025 

2 

40桁 X 25行， 

縦界線が有効 

VL 4020 

3 

40桁 x 20行， 

縦界線が有効 

BG 8025 

4 

80桁 x 25行， 

グラフ イ ック文字が有効 

BG 8020 

5 

80桁 x 20行， 

グラフ ィ ック文字が有効 

BG 4025 

6 

40桁 x 25行， 

グラフ イ ツク文字が有効 

BG 4020 

7 

40桁 x 20行， 

グラフ イッ ク文字が有効 
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VLxxxx を設定したときに画面に表示される文字ィメー ジは次のように 
なります。 


V し 

ANK コード 

シフト JIS コード 

VL オフ 

VL オン 

半角文字 

縦郓線つき半角文字 

全角文字 

縦罪線っき全角文字 

注意： VL オンとは ， text vertical に 

よって縦释線の表示が有効になって 


いることをいいます。 


BGxxxx を設定したときに画面に表示される文字イメージは次のように 
なります。 


BG 

ANK コード 

シフト JIS コード 

VL オフ 

VL オン 

半角文字 

簡易グラフィ. 

グラフ イ ック文字（半角） 
y クパターン 簡易グラフ イツ クハ 。ターン 


注意： BGxxxx の場合は，シフト JIS コードから J 1 S コードへの変換は行 
ないません。 


textmode が呼び出されると，カレントウィンドウは画面全体にリセット 
され，カレントテキスト«性は ノーマルに リセットされます。 ノーマル域 
性は normvideo によって設定される属性に対応します。 

戻り値 ありません。 

可搬性 textmode は PC .9801 でのみ 動作 します 0 対応する関数が Turbo Pascal に 

もあります。 

閣連項目 gettextinfo , window 
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textmode (IBM PC) 


機能 テキストモードを設定します0 

形式 void textmode (int newmode )； 


プロトタイプ conio.h 


解脱 textmode は，指定されたテキストモードを選択します。 

目的とするテキストモード（引数/は， conio . h に定我されている 
列举5/ WAT / mo ゴ打の中のシンボリック定数によって与えます。これらの 
定数を使用する場合には， conio . h をインクルードしなければなりません。 
text ⑺〇ゴ打型の定数，数値，およひ•設定されるモードは以下の通りです。 


定数名 

値 

テキストモード 

LASTMODE 

•1 

直前に設定したテキストモード 

BW 40 

0 

白黑，40桁 

C 40 

1 

カラー，40桁 

BW 80 

2 

白黑，80桁 

C 80 

3 

カラー，80桁 

MONO 

7 

モノクロ，80桁 


textmode が呼び出されると，カレントウィンドウは画面全体にリセット 
され，カレントテキスト厲性はノーマルにリセットされます。ノーマル厲 
性は normvideo によって設定される域性に対応します。 

LASTMODE を指定して textmode を呼び出すと，前回選択されたテキス 
トモードに再び設定されます。この機能は，グラフィックスモードを使用 
した後でテキストモードに戻るような場合にのみ有用となります。 


テキストビデオ関数リファレンス 
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textmode は，画面がテキストモードである（つまり現在のテキストモード 
を別のモードに変更する）場合にのみ使用されるべきです。画面がグラフ 
ィッ クスモードである場合には， restorecrtmode によってテキストモー 
ドに戻ってから， textmode を呼び出すようにしてください。 

戻り値 ありません。 

可撤性 textmode は， IBM PC およびその互換機でのみ動作します。これに対応す 

る関数が Turbo Pascal にもあります 0 

閲連項目 gettextinfo, window 
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textreverse (PC- 9801 のみ） 

機能 文字の反転属性をセットします。 

形式 # include <conio.h> 

void textreverse (int reverse )； 

ブロトタイプ conio.h 

解脱 textreverse は，文字の反転属性をセットします。引数 reverse には， conio. 

h に定義されているシンボリック定数 REVERSE (0 x 04) または NOR - 
EVERSE (0 x 00) を指定します。 

この関数の呼び出しは，以降に呼ひ•出される直接 コン ソール入出力関数 
(cprintf など）が出力する文字にのみ影響を与えます。すでに画面に表示 
されている文字，および printf などの標準入出カストリームを使用する関 
数が出力する文字には釤響を与えません。 

戻り値 ありません。 

可搬性 PC-9801 シリーズでのみ動作します。 

閭連項目 textattr 

例 /include <conio.h> 

void main() 

{ 

textrever8e(REVBRSE); 
cprintf (•反転表示 ¥r¥n” 
textreverse(NOREVERSE) 


/* 反転を設定*/ 
/* 反転を解 _ */ 


テキストビデオ関数リファレンス 
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textunder (PC-9801 のみ） 

機能 文字の下線属性をセットします。 

形式 # include く conio . h 〉 

void textunder(int under ) \ 

プロトタイプ conio.h 

解脱 textunder は，文字の下線械性をセットします 0 引数 wm / er には， conio.h 

に定我されているシンボリック定数 UNDERLINE (0 x 08) または NOUN - 
DERLINE (0 x 00) を指定します。 

この間数の呼び出しは，以降に呼び出される直.接コンソール入出力関数 
(cprintf など）が出力する文字にのみ影®を与えます。すでに W 面に表示 
されている文字，および printf などの標準入出カストリームを使用する関 
数が出力する文字には衫酈を与えません。 

戻り値 ありません。 

可搬性 PC -9801 シリーズでのみ動作します。 

関連項目 textattr 

例 /include く conio.h 〉 

void main() 

{ 

textunder(UNDERLINE) 
cprintf (•下練表示 ¥r¥n 


/* 下練を校定*/ 
I * 下練を解》 */ 
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text vertical(PC-9801 のみ ) 


機能 

文字の縦線属性をセッ 

卜します。 

形式 

# include < conio . h > 



void textvertical (int vertical ) \ 


プロトタイプ conio.h 


解脱 text vertical は，文字の縦線域性をセットします 0 引数 vertical には， conio . 

h で定義されている VERTICAL (0 x 10) または NOVERTICAL (0 x 00) 
を指定します。 

この関数の呼び出しは，以降に呼び出される政接 コン ソール入出力間数 
( cprintf など）が出力する文字にのみ影®を与えます。すでに画面に表示 
• されている文字，および printf などの標準入出カストリームを使用する関 

数が出力する文字には衫響を与えません。 

textvertical は，テキストモードが BGxxxx の場合には，グラフィック文 
字の表示切リ換えの意味になリます。 


戻り値 

ありません。 


可搬性 

PC -9801 シリーズでのみ動作します。 


閗連項目 

textattr，textmode 


例 

#include < conio . h > 
void main () 

ぐ 



textvertical ( VERTICALLINE ); 
cprintf ( ■禳鐮裹示 ¥ r ¥ n ' > ; 
textvertical ( HOVERTICALLINE ); 

/* 禳練を設定* 

1* 轘練を解 》* 
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wherex 


機能 

形式 

プロトタイプ 

解脱 

戻り値 
可撤性 

関連項目 

例 
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ウィンドウ内での水平方向のカーソル位萤を得ます。 
int wherex ^ void ) i 

conio.h 

wherex は，カレントテキストウィンドウ内での力ーソル位置の x 座標を 
返します。 

wherex は，1〜80の範囲の整数値を返します。 

wherex は， PC -9801 シリーズ（または IBM PC とその互換機）でのみ動作 
します。これに対応する関数は Turbo Pascal にもあります。 

gettextinfo , gotoxy，wherey 

printf (• The cursor is at (Zd f 2d)¥n* f wherex() f whereyO); 
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wherey 


機能 

形式 

プロトタイプ 

解脱 

戻り値 
可搬性 

関連項目 

例 


ウィンドウ内での垂直方向のカーソル位;*を得ます。 

int wherey ( void ) ； 

conio.h 

wherey は，カレントテキストウィンドウ内でのカーソル位逋の y 座樣を 
返します。 

wherey は，1〜25の範囲の整数値を返します。 

wherey は， PC -9801 シリーズ（または IBM PC とその互換機〉でのみ動作 
します。これに対応する関数は Turbo Pascal にもあります。 

gettextinio , gotoxy , wherex 

wherex を参照してください。 
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window 


機能 アクティブテキストウィンドウを定義します。 

形式 void window(int left , int top , int right , int bottom ) \ 

ブロトタイプ conio.h 

解脱 window は，画面上にテキストウィンドウを定義します。座標が有効でない 

場合は， window の呼び出しは無視されます。 
left ヒ top はウィン ドウの左上隅画面上の座標です。 
right と bottom は右下隅の画面上の座標です。 

テキストウィンドウの骹小の大きさは，1行1桁です。デフォルトウィンド 
ウは 》 i 面全体であり，次のような座標を持っています。 

■ PC -9801 : 

80桁25行モード （1,1) 一 （80,25) 

80桁20行モード (1.1) -(80.20) 

40桁25行モード （1.1) 一 （40,25) 

40桁20行モード （1,1) 一 （40.20) 

■ IBM PC : 

80桁モード (1.1) -(80.25) 

40桁モード （1，1) 一 （40,25) 

戻り値 ありません。 

可搬性 window は， PC -9801 シリーズ（または IBM PC とその互換機）でのみ動 

作します。これに対応する関数は Turbo Pascal にもあります。 

間連項目 clreol , clrscr , delline ， gettextinfo , gotoxy , insline , 

puttext , textmode 


504 


第 2 章 Turbo C ライブラリ 



グラフイックス関数リファレンス 


arc 


機能 円弧を描きます。 

形式 # include く graphics . h 〉 

void iar arc (int ズ， int y % int stangle , int endangle , int radius ) : 

プロトタイプ graphics.h 

解脱 arc は，円弧をカレントドロウカラーで描きます。 

arc は，中心が (ズ，夕)， 半径扣必似の円弧を描きます。円弧は 伽 叩 / e か 
ら endangle ま でです。 stangle = Q かつ em *7/? g/e = 360 の場合は， arc の呼び 
出しは完全な円を描きます。 

arc の角度は，反時計まわりで，0度が3時の方向，90度が12時の方向です。 

注意：カレントラインスタイルは，円弧には影響を与えませんが，ライン 
幅は円弧に形簪します。 

>主意 [IBM PC ] •• CGA のハイレゾリューシヨンモード，あるいはモノクロ 
グラフィ ッ クスアダプタを使用している場合，この マニュアル にあるサン 
ブルブログラムは期待通りに動かないことがあります。 CGA のハイレゾリ 
ユーシヨンモードまたはモノクロアダプタを使っている場合は，フィルカ 
ラー あるいはドロウカラーを セッ トする関数 （ setcolor , setfillstyle , set - 
linestyle など）には，シンボリック定数を使わずに，値1を渡すようにして 
ください。この後の例2で， CGA あるいはモノクロアダプタ上で， arc ， 
circle ， ellipse , getarccoords ， getaspectratio , および pieslice をどのよ 
うに使うかを示しています。 

戻り値 ありません。 


グラフイツクス関数リファレンス 
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可搬性 arc は PC -9801 シリーズ（または IBM PC とその互換機）でのみ動作しま 

す （IBM PC では，サポートするグラフィックスディスブレイアダプタを 
備えていなければなりません）。 

閣連項目 circle, ellipse, fillellipse ， getarccordes, Dieslice, sector 


例 1 linclude 《 graphics.h> 

#include <conio.h> 

main() 

{ 

int graphdriver _ DETECT, graphmode ； /* 自動幘 出の 饜 求 */ 
struct arccoordstype arcinfo ； 
int xa8p f yaspj 
long xlong ； 

initgraph(&graphdriver f Stgraphmode, ••); /* 初期化 */ 

/* 中心角 90 度で半径 50 の円 a */ 
arc(150 f 150 f 0 f 89 9 SO); 

i* 円 ® の座犓 ( を得て，弦を繡 ぶ*/ 
getarccoord8(&arcinfo) ; 
line(arcinfo.xstart f arcinto.ystart f 
arcinfo.xend # arcinfo.yend); 

/* 円を描く */ 
circle(150 f 150, 100)5 

/* 円の中に惰円を描く */ 
ellipse(150 # 150 f 0 t 359,100, 50); 

/* 属 si を描いてフイルする */ 

setcolor (WHITE) s /* 輪驊は白 */ 

8etfill8tyle(S0LID_PILL # LIGHTRED); 
pieslice(100, 100 • 135, 49); 

8etfill8tyle(S0LID_FILL, LIGHTBLUE); 
pie8lice(100 f 100, 135 f 225, 49); 

8etfillstyle(S0LID_FILL, WHITE); 
pieslice(100, 100, 225 f 360, 49); 

i* 長方形を描く */ 

geta8pectratio(&xa8p f &yasp )： 

xlong ■(100L * (long)yasp) / (long)xasp; 

rectangle(0 9 0 f (int)xlong f 100) ; 

getch(); 

closegraphO; 


506 


第 2 章 Turbo C ライブラリ 




int graphdriver - DETECT t 
struct arccoordstjrpe arcinfo 
int xa8p t yasp; 
long xlongs 

initgraph( Jtgraphdriver • &gra 

I* 中心角 90 度で半 350 の円 **/ 
arc( 100 • 120, 0, 89 f 50 ); 

/* 円 * の遍標を得て，铱を舾ぶ * 

getarccoord8( &arcinfo ) ； 
line(arcinfo.xstart f arcinfo 
arcinfo.xendt arcinfo.y 

/* 円を描く */ 

circle ( 100 f 120 9 80 )$ 



ellip8e(100 f 120 t 0 f 3S9 t 80 
/* 屬 » を攉いてフィルする */ 

8etfill8tyle(HATCH_PILL # 1) 5 
pieslice(200 f 50 t 0 t 134 f 49 
8etfill8tyle(SLASH_PILL f 1); 
pieslice(200 # 50 t 135 f 225 9 ^ 
8etfill8tyle(WIDE_D0T_PILL f : 
pie8lice(200 f 50 f 225 f 360, i 

/* 長方形を描く*/ 

getaspectratio(4xa8p f ” asp); 
xlong _ (50L * (long) yasp) j 
rectangle( 0 t 0 f (int)xlong f ! 
getch(); 
closegraphO ； 


グラフィックス関数リファレンス 


bar 


機能 

形式 

ブロトタイプ 

解脱 


戻り値 

可搬性 

関連項目 

例 
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二次元バー（長方形）を描きます。 

# include く graphics . li > 

void far bar(int left 、int top , int right , int bottom ) : 

graphics.h 

# include < conio . h > 

bar は，フィルされた二次元バー（長方形）を描きます 0 ハ•一は，カレント 
フイルパターンとフィルカラーを使ってフィルされます。 bar は長方形の 
輪郭は描きません。綸郭のある2次元の八一を描くには， depth を Q にして 
bar 3 d を用いてください。 

技方形の左上と右下は， ( left , top 、 と ( right , bottom ) で与えます。これ 
らの座標は，ピクセルを参照します。 

ありません。 

bar は PC -9801 シリーズ（または IBM PC とその互換機）でのみ動作しま 
す （IBM PC では，サポートするグラフィックスディスプレイアダプタを 
備えていなければなりません）。 


bar 3 d , rectangle , setcolor，setfillstyle 


#include <graphics.h> 

main() 

{ 

int graphdriver - DETECT, graphmode; /* 自動検出を要求*/ 

initgraph(&graphdriver f &graphmode 9 /* 初期化 */ 

3 etfill 8 tyle ( S 0 LID _ FILL f MAGENTA ); 

bar3d(100 f 10 t 200,100 • 5,1); 

setfillstyle(HATCH_FILL t RED); 

bar(30 f 30 f 80 f 80,); 

getcheO ； 
closegraph(>; 


第 2 章 Turbo C ライブラリ 




bar3d 


機能 

形式 

プロトタイプ 

解脱 


戻り値 

可撤性 

関連項目 

例 


3 次 7 C バーを描きます。 


# include < graphics . h > 

void far bar3d(int left 、int top 、int right, int bottom ， 

int depth, int lop flag )； 


graphics.h 

bar 3 d は， 3 次元;のバーを描き，カレントフイルハ•ターンとフイルカ ラーで 
中をフイルします。バーの 3 次元の綸郭は，カレントラインスタイルとカラ 
一で 描きます。バーの奥行きは，ビクセル数で， depth によって与 . えます。 
top/lag [i 、 バーに 3 D トップをつけるかどうかを指定するために使います。 
top/lag が〇でなけ H ば， トップがつけられます。そうでなければ，（バーを 
憒み ffi ねることを可能とするために）バーにトッブをつけません。 bar 3 d 
は，長方形の左上と右下を， (left 、 top) と (right ， bottom) で与えます。 
bar 3 d の典型的な奥行きは，次のようにバーの幅の 25% をとればよいでし 
よラ 0 


bar3d(left, top, right, bottom, (right - reft)/4,1); 

ありません 9 


bar 3 d は PC -9801 シリーズ（または IBM PC とその互換機）でのみ動作し 
ます （ IBMPC では，サポートするグラフィックスディスプレイアダプタ 
を備えていなければなりません）。 


bar , rectangle , setcolor , setfillstyle , setlinestyle 

bar を参照,してください。 


グラフィックス 関数 リファレンス 


509 


circle 


機能 

形式 

プロトタイブ 

解脱 


戻り値 

可撤性 

関連項目 

例 
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与えられた半径で指定の点を中心に円を描きます。 

# include く grapnics.h〉 

void far circle (int x y int 夕 ， int radius ) : 

graphics.h 

circle は，カレントドロウカラーで，中心（ズ,夕）に，半径 rarf /奶の円を描 
きます。 


注意：カレントラインスタイルは，円周には影響を与えません。ただしラ 
イン幅は円周に影響します。 

各グラフィックスドライバとグラフィックスモードには，アスべクト比（ビ 
クセルの縦横比)が含まれています。 circle は，画面に弧を描く際のスケー 
リングとしてこのアスべクト比を使います。使用しているディスブレイで 
円が真円として描かれない場合には， setaspectratio によって，アスべク 
卜比を調整することができます。 

ありません。 

circle は PC-9801 シリーズ（または IBM PC とその互換機）でのみ動作し 
ます （IBMPC では，サポートするグラフィックスディスプレイアダプタ 
を備えていなければなりません）。 


arc，ellipse, fillellipee, getaspectratio, pieslice，sector, 
setaspectratio 

arc を参照してください。 
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cleardevice 


機能 

形式 

プロトタイプ 

解脱 

戻り値 

可撤性 

M 連項目 


グラフイックス画面をクリアします。 

# include <graphics.h> 
void far cleardevice (void )； 


graphics.h 


cleardevice は，グラフィックス画面全 ^ をクリアし（つまりカレントバツ 
クグラウンドカラーでフィルします ）， CP (カレントポジション）をホーム 
ポジション （0,0) に移します。 

ありません。 

cleardevice は PC 9801 シリーズ（または IBM PC とその互換機）でのみ 
動作します （ IBMPC では，サポートするグラフィックスディスプレイア 
ダブタを備えていなければなりません）。 


clearviewport 


グラフイックス関数リファレンス 
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clearviewport 


機能 

形式 

プロトタイプ 

解脱 

戻り値 
可搬性 

閫連項目 

例 
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カレントビューポートをクリアします。 

# include <graphics.h> 
void far clearviewport (void) : 


graphics.h 


clearviewport は，ビューボートをクリアし ， CP (カレントポジション) 
をビューポート相対のホームポジション（0,0)に移します。 

ありません。 


clearviewport は PC -9801 シリーズ（または IBM PC とその互換機）での 
み動作します （IBM PC では，サボートするグラフィックスディスプレイ 
アダプタを備えていなければなりません）。 


cleardevice ， getviewsettings, setviewport 
linclude <graphics.h> 


main() 

{ 

int graphdriver _ DETECT ， graphmode; /* 自動楨出を * 求 */ 
setviewport( 30 t 30 t 130,130 • 0>; 

outtextxy(10 f 10 1 *Het any key to clear viewport •••■〉； 
getch(>; /* キー入力 待ち */ 

clearviewportO; /* キー入力があつたらビューボートをクリア*/ 
closegraphO; 
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closegraph 


機能 グラフイックスシステムの使用を終了します。 

形式 # include <graphics.h> 

void far closegraph (void) : 


プロトタイプ graphics.h 

解脱 closegraph は，グラフ イッ クスシステムによって割り当てられたメモリを 

解放し， initgraph を呼び出す前のモードに画面を戻します（グラフィック 
スシステムは， graphfreemem を呼び出して，ドライバ，フォント，内部 
ハ•ッファなどに使用していたメモリを解放します） 0 

戻り値 ありません。 

可撤性 closegraph は PC -9801 シリーズ（または IBM PC とその互換機）でのみ 動 

作します （ IBMPC では，サポートするグラフィックスディスプレイアダ 
ブタを備えていなければなりません）。 

間連項目 initgraph, setgraphbufsize 


グラフイックス閫数リファレンス 
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detectgraph 


機能 ハードウェアをチェックして，使用すべきグラフィックスドライバとモー 

ドを決定します。 

形式 # include < graphics . h > 

void far detectgraph (int lar * graphdriver , int far * graphmode ) : 

プロトタイプ graphics.h 

解脱 detectgraph は，使用しているシステムに装備されているグラフィックス 

ハードウヱアを検出し，最商の品質が得られるグラフィックスドライバと 
モードを決定します。 

PC -9801 では， GRCG あるいは EGC が備えられているかどうかを調べ，煅 
も商速な出力，およひ M 096 色中16色が使用可能か（あるいは8色のみか）ど 
うかを検出します。 

IBM PC では，どのグラフィックスアダプタが装着されているかを調べ， 
そのアダプタで最も高い解像度が得られるモードを選択します。グラフィ 
ックスアダプタがなにも検出できない場合には，* graphdriver に-2がセ 
ットされ， graphresult は-2を返します。 
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木 graphdriver (i, 
れには ， graphics 


graphics drivers 定数 

DETECT 

CGA 

MCGA 

EGA 

EGA64 

EGAMONO 

IBM8514 

HERCMONO 

ATT400 

VGA 

PC3270 

PC98 

PC98GRCG 

PC98EGC 


グラフイックス関数リファレンス 




11 (PC9801 のみ ) 

12 (PC.9801 のみ ) 

13 (PC.9801 のみ ) 


ネ graphmode は， 初期グラフィックスモードを示す整数です（ただし， 

* graphdriver が DETECT に等しい場合には，* graphmode は検出され 
たドライバにおいて妓も高い解像度が得られるモードにセットされます）。 

* graphmode には , graphics.h で定義されている以下のような列挙型 
graphics modes の定数を与えることができます。 


PC98 


PC98C8 


640X400 


PC98C16 


640X400 


PC98GRCG 


PC98C8 

PC98C16 


640X400 


FC98EGC 


PC98C8 

PC98C16 


640X400 
640 x 400 


CGA 


CGAC0 

CGAC1 

CGAC2 

CGAC3 

CGAHI 


320 x 200 
320X200 
320 X 200 
320 x 200 
640 x 200 


MCGA 


MCGAC0 

MCGAC1 

MCGAC2 

MCGAC3 

MCGAMED 

MCGAHI 


320 x 200 
320 x 200 
320 x 200 
320 x 200 
640 x 200 
640 X 480 


EGA 


EGALO 


640 X 200 


EGAHI 


640 x 350 
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EGA 64 

EGA 64 LO 

0 

640 X 200 

16色 

1 


EGA 64 HI 

1 

640 X 350 

4色 

1 

EGAMONO 

EGAMONOHI 

3 

640 X 350 

2色 

1* 


EGAMONOHI 

3 

640 X 350 

2色 

2本本 

HERC 

HERCMONOHI 

0 

720 X 348 

2色 

2 

ATT 400 

ATT 400 C 0 

0 

320 X 200 

C 0 

1 


ATT 400 C 1 

1 

320 X 200 

C 1 

1 


ATT 400 C 2 

2 

320 X 200 

C 2 

1 


ATT 400 C 3 

3 

320 x 200 

C 3 

1 


ATT 400 MED 

4 

640 x 200 

2色 

1 


ATT 400 HI 

5 

640 X 400 

2色 

1 

VGA 

VGALO 

0 

640 X 200 

16色 

2 


VGAMED 

1 

640 x 350 

16色 

2 


VGAHI 

2 

640 X 480 

16色 

1 

PC 3270 

PC 3270 

0 

720 x 350 

2色 

1 

IBM 8514 

IBM 8514 HI 

0 

640 X 480 

256色 

2 


IBM 8514 LO 

1 

024 X 768 

256色 

2 


* 64 K EGA モノカード 

ホ* 256 K EGA モノカード 


注意： detectgraph を直接呼び出す主な理由は， detectgraph が init - 

graph に対して推奨するグラフィックスモードを変更することにありま 
す。 

戻り値 ありません。 


グラフィックス 関数 リファレンス 
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可搬性 


detectgraph は PC-9801 シリーズ（または IBM PC とその互換機）でのみ 
動作します。 


M 連項目 graphresult, initgraph 
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drawpoly 


機能 多角形の輪郭を描きます。 

形式 # include く graphics . h 〉 

void far drawpoly unt numpoints , mt far * poly points ) \ 

プロトタイプ graphics.h 

解説 drawpoly は，頂点の数が numpoints の 多角形を，カレントラインスタイル 

とカラーで描きます。 

polypoints li , ( 仙爪パ / 肪 ><2 個の）整数の並びを指します。整数の各ベア 
は，それぞれ多角形の頂点のズ座標と夕座樣を与えます。 

注意： n 個の頂点からなる閉じた図形を描くためには，番目の座標が〇番 
目の座標に等しい"+1組の座標を， drawpoly に渡さなければなりませ 

ん〇 

戻り値 多角形を描いているときにエラーが発生した場合， graphresult は-6を返 

します。 

可撤性 drawpoly は PC -9801 シリーズ（または IBM PC とその互換機）でのみ動 

作します （IBM PC では，サポートするグラフィックスディスプレイアダ 
ブタを備えていなければなりません）。 

閲連項目 fillpoly , floodfill graphresult，setwritemode 


グラフイックス 関数 リファレンス 


519 




/include <graphics-h> 

#include <conio.h> 

main() 

{ 

int graphdriver - DETECT, graphmodc; 
int triangle【 】 _ {50,100, 100 t 100 t 150, 
int rhombus[ ] - {50,10, 90,50, 50,90 f 1 

initgraph(&graphdriver f &graphmode f _■); 

i * 三角形を描く*/ 

drawpoly(sizeof(triangle)/(2*sizeof(int) 

/* 平行四辺形を描いてフイルする*/ 
fillpoly(sizeof(rhombus) / (2*sizeof(int 


getche(); 

closegraphO; 




ellipse 


機能 

形式 

プロトタイプ 

解脱 


戻り値 

可撤性 

関連項目 

例 


楕円弧を描きます。 

# include く graphics . h 〉 

void far ellipse (mt x , mt 夕 ， int stangle ，int enaangle , 

int xradius 、int yradius ) \ 


graphics.h 

ellipse は，中心が ( ズ , 夕)， 水平軸と鉛直軸がそれぞれ; と yradius で 
与えられる惰円弧をカレント ドロウカラー で描きます。弧は stangle か h 
endangle ま でです 。 sfangfe = 0 および em/a 叹 /e = 360の場合は， ellipse の呼 
び出しは完全な楕円を描きます。 

ellipse に与える角度は反時計まわりで，0度が時計で3時の方向，90度が12 
時の方向になります。 

注意：カレントラインスタイルは楕円弧には杉®を与えません。ただし， 
ライン幅は惰円弧に影饗します。 


ありません。 


ellipse li PC -9801 シリーズ（または IBM PC とその互換機}でのみ動作し 
ます （ IBMPC では，サポートするグラフィックスディスプレイアダプタ 
を備えていなければなりません）。 


arc , circle , fillelupse , getaspectratio , pieslice , sector , 
setaspectratio 

arc を参照してください。 


グラフィックス関数リファレンス 
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fillellipse 


機能 

形式 

プロトタイプ 

解脱 

戻り値 
可搬性 

関連項目 

例 
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搰円を描いてフィルします。 

# include く graphics . h 〉 

void far nilellipseunt x % int 夕 ， int xraaius ,int yradius ) : 
grapnics.h 


fillellipse は，中心が U ， 夕)，水平袖と鉛直軸がそれぞれズと yradius 
で与えられる搰円弧を描き，その中をカレントフイルカラーとフイルバタ 
ーンでフイルします。 

ありません。 


fillellipse は PC -9801 シリーズ（または IBM PC とその互換機）でのみ動 
作します （IBM PC では，サポートするグラフィックスディスプレイアダ 
ブタを備えていなければなりません）。 

arc , circle , ellipse , getaspectratio , piesuce ， sector , 
setaspectratio 


arc を参照してください。 
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fillpoly 


機能 

多角形を描いてフイルします。 


形式 

# include く graphics . h 〉 



void lar fillpoly unt numpoints ,11 

fit far * poly points ) \ 


ブロトタイプ graphics.h 

解脱 fillpoly は，カレントラインスタイルとカラーで多角形を描き (drawpoly 

と同じ），カレントフィルスタイルとフィルカラーでその多角形をフィルし 
ます。 

polypoints は， X 2) 個の整数の並びを指します 0 按数の各ベア 
は，それぞれ多角形の頂点のズ座標と夕座標を与えます。 

戻り値 ありません。 

可搬性 fillpoly は PC -9801 シリーズ（または IBM PC とその互換機）でのみ動作 

します （ IBMPC では，サポートするグラフィックスディスブレイアダブ 
夕を備えてぃなければなりません）。 

関連項目 drawpoly , floodfill graphresult , setfillstyle 


グラフィックス 関数 リファレンス 
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floodfill 


機能 指定の境界カラーで囲まれた領域をフィルします。 

形式 林 include く graphics . h 〉 

void far floodfill (int ズ ， int 夕 ， int border ) \ 

プロトタイプ graphics.h 

解脱 floodfill は，ビットマップデバイス上の閉じた領域をフィルします。 

(ズ，夕）は，閉じた領域内のシードポイント（フィルを開始する点）です。 
境界カラーか/•で囲まれた領域が，カレントフィルパターンとフィルカ 
ラーでフィルされます。シードボイントが閉じた領域の内側にある場合は 
領域の内側がフィルされ，外側にある場合は領域の外側がフィルされます。 
将来のバージョンとの互換性を保つためには，可能な限り floodfill ではな 
く fillpoly を用いてください。 

注意： IBM -8514 のドライバでは， floodfill は動作しません。 

戻り値 領域をフィルしているときにエラーが発生した場合， graphresult は-7を 

返します。 

可撤性 floodfill は PC 9801 シリーズ（または IBM PC とその互換機）でのみ動作 

します （ IBMPC では，サポートするグラフィックスディスプレイアダブ 
夕を備えていなければなりません）。 

閗連項目 drawpoly , fillpoly , graphresult , setcolor，setfillstvle 
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例 


/include <graphics.h> 


main() 

{ 

int graphdriver - DETECT • graphmode; /* 自動桷出を裏求 */ 

ini tgraph (&graphdriver f &graphmode 9 _■>; /* 初期化 */ 

/* 3D バーを描いて，侧面と上面をフィルする */ 

8etcolor(WHITE) ; 

8etfill8tyle(HATCH_PILL, LIGHTMAGBNTA ) 5 
bar3d(10 t 10 f 100 f 100 t 10 f 1 )； 

8etfill8tyle(S0LID_FILL f LIGHTGREEN); 
floodfill(102 t 50 f ~WHITE)s /* 侧面をフィル */ 

floodfill(50 t 8 f WHITE); /* 上面をフイル */ 

clo8egraph () ； 


グラフイックス関数リフアレンス 
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getarccoords 


機能 


arc の最新の呼び出し時の座標を得ます。 


形式 


# include <graphics.h> 

void far getarccoords (struct arccoordstype far * arccoords) 


プロトタイプ graphics.h 


解脱 


getarccoords は，似 rcoo / Yfe が指す arccoordstype 構造体を，最後の 

の呼び出しに関する悄報で埋めます。 

arccoordstype 稱造体は， graphics.h で次のように定義されています。 


ict arccoordstype { 
int x f y; 

int xstart f ystart f xend f yend 


この構造体のメンバは，弧の中心（ズ,少)，出発点 Restart , ystart ), 終了点 
めを示しています。これらの値は，弧の端を通る線を描く必要 
がある場合に便利です。 


戻り値 


ありません。 


可搬性 


getarccoords は PC .9801 シリーズ（または IBM PC とその互換機）でのみ 
動作します （IBM PC では，サポートするグラフィックスディスプレイア 
ダブタを備えていなければなりません）。 


arc , fillellipse , piesiice , sector 


arc を参照してくださ 
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getaspectratio 


機能 カレントグラフィックモードにおけるアスぺクト比を返します0 

形式 # include < graphics . h > 

void far getaspectratio(int far 本 xasp ,int tar 木 yosp ). 


プロトタイプ graphics.h 

解脱 タ アスペクト因子* 夕仍 P は，10000に正規化されています。 

PC-9801 ではピクセルが正方形になっているので，* xas P = * y as P とな 
ります。 

IBM PC の場合， VGA を除くすべてのグラフイックスアダプタでは，ピク 
セルは横より縦が長いので，* xasp[x 了スぺク ト因子）は* 初より小 
さい値になります。 VGA ではピクセルは正方形なので，* xasp t # yasp 
は等しくなります。一般に* yasp と* xasp の関係は次のようになってい 
ます。 

+ yasp =10000 
* xasp く =10000 

getaspectratio は ，* ズ似 p と* yasp の 値を得ます 0 

戻り値 ありません。 

可搬性 getarccoords は PC-9801 シリー ズ (または IBM PC とその互換機）でのみ 

動作します （IBM PC では，サポートするグラフィックスディスブレイア 
ダブタを備えていなければなりません ）。 Turbo Pascal に同様なルーチン 
があります。 

関連項目 arc, circle, ellipse, fillellipse. pieslice ， sector, setaspectratio 

例 arc を参照してください 0 


グラフィックス 関数 リファレンス 
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getbkcolor 

機能 カレントバックグラウンドカラーを得ます。 

形式 林 include く graphics.h 〉 

mt far getbkcolor(void) : 

プロトタイプ graphics.h 

解脱 getbkcolor は，カレントバックグラウンドカラーを返します（詳細につい 

ては setbkcolor を参照してください）。 

戻り値 getbkcolor はカレン トバック グラウンドカラーを返します。 

可搬性 RetbkcoloHiPC -980 biJ — ； CU 々 KIBMPC とその互換機）でのみ動 

作します （ IBMPC では，サポートするグラフィックスディスプレイアダ 
ブタを備えていなければなりません）。 

関連項目 g ： etcolor ， getmaxcolor, getpalette, setbkcolor 


例 


#include <graphics.h> 

#include <conio.h> 

#include <dos .h> 

main() 

{ 

int graphdriver ■ DETECT f graphmode; /* 自動 挨出を顯求*/ 
int svcolor; 

initgraph( igraphdriver, igraphmode, ■■); /* 初期化*/ 


svcolor - getbkcolor ()； /* カレントバックカラーをセーブ 
setbkcolor (sccolor ^ 1 )；/* カレントバックカラーを変更 
delay(5000 )； /* 5 秒間待つ 

setbkcolor (svcolor) ; /* 元のカラービ屏す 



getche ()； 
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getcolor 


檐能 

形式 

プロトタイプ 

解脱 

戻り値 

可搬性 

関連項目 

例 


カレントドロウカラーを得ます0 

# include <graphics.h> 
int rar getcolor (void) : 

graphics.h 

getcolor は，カレントドロウカラーを返します 0 

その範囲は0から getmaxcolorO までです。ドロウカラーとは，線などを描 
くときにピクセルにセットされる値のことです。たとえば PC 98 C 8 モード 
では， getcolor 〇が4を返せばカレントドロウカラーは紫色になります。 


getcolor はカレントドロウカラーを返します。 

getcolor は PC -9801 シリーズ（または IBM PC とその互換機）でのみ動作 
します （ IBMPC では，サポートするグラフィックスディスプレイアダブ 
夕を備えていなければなりません）。 


getDKcolor ， getmaxcolor ， getpalette, setcolor 


#include <graphics.h> 
/include <conio.h> 


main() 

{ 

int graphdriver - DETECT f graphmode; /* 自動槍出を襲求 */ 
int svcolor; 


initgraph( igraphdriver f igraphmode, ••>; /* 初期化 */ 


svcolor _ getcolor ()； 
8etcolor(3); 
circle(100 f 100, 5); 
8etcolor(svcolor); 


/* カレントドロウカラーをセーブ */ 

I* ドロウカラーにバレット番号 3 を設定 */ 
/* カラーの小さな円 */ 

I* ドロウカラーを元に霣す */ 


getcheO ； 

closegraphO ； 


グラフィックス関数リファレンス 
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getdefaultpalette 


機能 

形式 

プロトタイプ 
解脱 

戻り値 

可撤性 

M 連項目 
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バレット定義構造体を返します0 

# include く graphics.h 〉 

void far ホ far getdefaultpalette (void) : 

graphics.h 

getdefaultpalette は， initgraph の呼び出し中にドライパによって初期化 

されたパレットを持っている palettetype 構造体を見っけます。 

getdefaultpalette は，カレントドライバが初期化されたときに，そのドラ 
イバによってセットアップされたデフォルトバレットへのボインタを返し 
ます。 

getdefaultpalette は PC -9801 シリーズ（または IBM PC とその互換機）で 
のみ動作します （ IBMPC では，サポートするグラフィックスディスブレ 
イアダプタを備えていなければなりません）。 

getpalette ， initgraph 
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getdrivername 


機能 カレントグラフィックスドライバの名前を持つ文字列を返します。 

形式 # include く graphics . h 〉 

char * far getdrivername ( void ). 

プロトタイプ graphics.h 

解脱 initgraph を呼び出し後， getdrivername は現在ロー ドされているグラフ 

ィックスドライバの名前を返します。 

戻り値 getdrivername は，グラフィックスドライバを示す文字列へのボインタを 

返します。 

可撤性 getdrivername は PC -9801 シリーズ（または IBM PC とその互換機）での 

み動作します （IBM PC では，サボートするグラフィックスディスブレイ 
アダプタを備えていなければなりません）。 

M 連項目 getmodename , initgraph 


グラフィックス 関数 リファレンス 
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getfillpattern 


機能 

ユーザ定義のフィルパターンをメモリにコピーします。 

形式 

# include <graphics.h> 

void far getfillpattern(char tar * pattern ) \ 

プロトタイプ 

graphics.h 

解脱 

getfillpattern は， setfillpattern で設定されたユーザ定義のフィルハ•ター 

ンを，咫が指している 8 バイト領域にコピーします。 

pattern は8バイ ト列を指すポインタで，各バイトはパターン内の 8 ピクセル 

に対応しています。ハ•ターン内で 1 に設定されているビットに対応するピク 
セルがブロットされます。たとえば，次のユーザ定義のフィルバターンは 

チェッカー盤を表わしています。 


char checkerboard 【 8】■ { 

OxAA, 0x55 f 0xAA t 0x55 f 0xAA f 0x55• 0xAA t 0x55 

)； 

戻り 値 

ありません。 

可搬性 

getfillpattern は PC -9801 シリーズ（または IBM PC とその互換機）での 
み動作します （ IBMPC では，サポートするグラフィックスディスプレイ 
アダプタを備えていなければなりません）。 

間連事項 

getfillsettings , setfillpattern 
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getfillsettings 


機能 カレントフィルハ•ターンとフィルカラーに関する情報を得ます。 

形式 # include <graphicis.h> 

void iar getfillsettmgs (struct fillsettingstype far * fillinfo ) : 

プロトタイプ graphics.h 


解脱 getfillsettings は， fillinfo が指している fillsettingstype 型構造体に，カレ 

ント フイ ルハ•ターンと フイ ルカラーを冉き込みます。 fillsetting：stype は， 
graphics.h の中で次のように定義されています。 


struct fill8etting8type { 

int pattern; /* カレントフイルバターン */ 

int color; /* カレントフイルカラー */ 

)； 

bar , bar 3 d ， fillpoly, floodfill, pieslice は，すべてカレントフィルハ•夕 
ーンとフイルカラーで領域をフイルします。定莪済みのフイルバターンは 
11神•類あります（ベタ绝りやクロス ハッチ， ドットなど）。 

定義済みパターンのシンボル名は， graphics.h の fill patterns テーブルに 
与えられています（下の表を参照)。これに加えてユーザは独白のフィルパ 
ターンを定義することができます。 

pattern が U (USER FILL ) に等しい場合は，ユーザ定我のフィルハ。ター 
ンが用いられています。それ以外の場合は定義済みバターンの数値が与え 
られます。 


グラフィックス関数リファレンス 
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戻り値 

可撤性 

関連事項 

534 


graphics.h で定義されている列挙型/?// /^/ rer" は，定義済みフイルパター 
ンの名前とユーザ定義バターンの指示子を与えています。 


名前 

値 

機能脱明 

EMPTYFILL 

0 

バックグラウンドカラーでフィル（中空) 

SOLID_FILL 

1 

ベタ璗り 

LINE 一 FILL 

2 

横線でフィル 

LTSLASHFILL 

3 

///でフィル 

SLASHFILL 

4 

///でフィル，太線 

BKSLASHFILL 

5 

\\\でフィル，太線 

LTBKSLASH FILL 

6 

\\\でフィル 

HATCH 一 FILL 

7 

淡いハッチ（格子）でフィル 

XHATCHFILL 

8 

濃いクロス ハッチ （斜めの格子）でフィル 

INTERLEAVEFILL 

9 

インターリーブ線でフィル 

WIDE _ DOT_FILL 

10 

すき間が広い点でフィル 

CLOSE 一 DOT_FILL 

11 

すき間が狭い点でフィル 

USER—FILL 

12 

ユーザ定義のフイルハ•ターン 


EMPTYFILL 以外のものは，カレントフイルカラーでフイルします0 
EMPTY _ FILL は，カレントバックグラウンドカラーを用います。 

ありません。 

getfillsettings は PC -9801 シリーズ（または IBM PC とその互換機）での 
み動作します （ IBMPC では，サポートするグラフィックスディスプレイ 
アダプタを備えていなければなりません）。 


getfillpattern ， setfillpattern , setfillstyle 
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例 


/include <graphics.h> 
/include <conio.h> 


main() 

{ 

int graphdriver - DETECT t graphmode; I* 自動検出を蜃求 */ 
struct fillsettingstype save; 
char 8avepattern[8]; 
char gray50[) - 

{ Oxaa f 0x55 f 0xaa f 0x55 t 0xaa 9 0x55 f Oxaa, 0x55 >; 
initgraph(4graphdriver f igraphmode, •■); /* 初期化 */ 


getfill8etting8(5r8ave); 
if (save.pattern ■■ USER_FILL) 
getfillpattern(savepattern); 



現在の設定を得る */ 
ユーザ定義パターンならば 
そのパターンをセーブ */ 



setfill3tyle(SLASH_FILL f BLUE); 
bar( 0 f 0 f 100,100); 


/* フィルスタイルを * 更 */ 

I* 青で料！！フィルのバーを描く 



8etfillpattern(gray50 # YELLOW ) ； / 
bar(100 f 100 f 200 f 200); / 


ユーザ定義パターンで */ 
黃色のバーを描く */ 


if (save.pattern ■■ USER_FILL) 

8etfillpattern(8avepattern, 

else 


/* ユーザ定義パターンならば 
/* ユーザ定義パターンを回復 


8ave.color) ; 

/* 元のスタイルを 80 後 */ 


setfill 8 tyle(save.pattern, 



.color); 



getcheO; 

closegraphO; 
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getgraphmode 


機能 

形式 

プロトタイプ 

解脱 

戻り値 

可撤性 

間連項目 

例 
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カレントグラフィックスモードを返します 0 

# include <graphics.h> 
mt far getgraphmode (void) : 


graphics.h 


getgraphmode を呼び出す前に，ブログラムは initgraph の呼び出しに成 
功していなければなりません。 

graphics.h で定我されている列挙型 graphics mode は ，システム定義のグ 
ラフ イツ クスモードの名前を与えています。この列挙型の値については 
initgraph の解説を参照してください。 


getgraphmode は， initgraph または setgraphmode で設定されたカレン 
トグラフィックスモードを返します。 

getsraphmode は PC -9801 シリーズ（または IBM PC とその互換機）での 
み動作します （ IBMPC では，サポートするグラフィックスディスプレイ 
アダプタを備えていなければなりません）。 


geimoderange , estorecrtmode , setg：raphinode 


int cmode : 


cmode _ getgraphmode() 5 /* カレントモ ー K をセーブ */ 

restorecrtmodeO ； /* テキストモードに移行 */ 

printf("Now in text mode • • 

•press any key to go back to graphics •••_〉； 


getcn ()； 

setgraphmode (cmode); /* グラフイツクスモードに戻る */ 
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getimage 

檐能 指定された領域のビットイメージをメモリへセーブします。 

形式 # include く graphics . h 〉 

void iar getimageunt left 、int top 、int right ， 

int bottom , void far * bitmap ) \ 

プロトタイプ graphics.h 

解脱 getimage は，画面上の長方形領域のビットイメージをメモリにコピーし 

K left 、 top 、 right ， bottom は， コピーされる画面上の S 方形を定我し 
ます。 bitmap は ，ビットイメージが格納されるメモリ内の領域を指しま 
す。この領域の最初の2ワードには畏方形の幅と岛さが格納され，残りの部 
分にイメージそのものが格納されます。 

戻り値 ありません。 

可撤性 getimage は PC -9801 シリーズ（または IBM PC とその互換機）でのみ動 

作します （ IBMPC では，サポートするグラフィックスディスプレイアダ 
ブタを備えていなければなりません）。 

閭連項目 imagesize ， putimag ： e, putpixel 
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#include <alloc.h> 

#include <graphics.h> 

main() 

{ 

int graphdriver - DETECT f graphmode; 
void *buffer; 
unsigned size ； 


initgraph(^graphdriver f &graphmode 9 



size ■ image8ize(0 9 0 9 20 9 10); 
buffer _ malloc(size) : 
getimage(O f 0, 20 t 10, buffer )5 
/* … *1 

putimage(O f 0 f buffer• C0PY_PUT); 
free(buffer); 



clo8egraph(); 



getlinesettings 


機能 カレントラインスタイル，パターン，幅を得ます。 

形式 # include < graphics . h > 

void far getlinesettings(struct linesettingstype far * lineinfo ) : 

プロトタイプ graphics.h 

解脱 getlinesettings は， lineinfo が指している linesettingstype 構造体に，力 

レントラインスタイル，パターン，幅に関する情報を宵き込みます。 
linesettingstype 構造体は， graphics . h で次のように定義されています。 


struct linesettingstype { 
int linestyle; 
unsigned upattern ； 
int thickness ： 

)； 


linestyle は， それ以降に描かれるラインのスタイルを指定します（たとえ 
ば，灾線，点線，一点锁線，破線)。 graphics . h で定義されている // We style 
テーブルには，これらの演算子の名前が与えられています。 


名前 


値 意味 


SOLIDLINE 
DOTTEDLINE 
CENTERLINE 
DASHEDLINE 
USERBIT LINE 


0 実線 



2 一点鎖線 

3 破線 

4 ユーザ定義のラインスタイル 



thickness [ i , それ以降に描かれる線の幅が，普通か太いかを指定するもの 
です。 


名前 値 意味 


NORMWIDTH 
THICK WIDTH 



3 ピクセル幅 


upattern li t linestyle が USERBIT LINE (4) のときにのみ適用される 16 ビ 
ットパターンです。その場合，パターンワード内の1のビットに対応するラ 
イン内のピクセルが，カレントドロウカラーで描かれます。たとえば，実 
線は OxFFFF の upattern (すべてのピクセルの描画）に対し、破線は 
0x3333 または OxOFOF の upattern に対応します。 setlinestyle の引数 lines - 
/夕が USERBIT _ LINE (4) でない場合も， upattern は与えなければなりま 
せん（無視されますが)。 

戻り値 ありません。 

可搬性 getlinesettings は PC -9801 シリーズ（または IBM PC とその互換機）での 

み動作します （ IBMPC では，サポートするグラフィックスディスプレイ 
アダプタを備えていなければなりません）。 

関連項目 setlinestvle 


540 
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#in 


main() 

{ 

int graphdriver - DETECT, graphmode ； /* 自動 禎 出を 裏 求 */ 
struct linesettingstype saveline ； 

mitgraph( igraphdriver f &graphmode 9 •■); /* 初期化 */ 

getlinesettings(isavelinG )； /* ラインスタイルをセーブ */ 
8etlinestyle(S0LID_LINE f 0 f THICK WIDTH); 

rectangle(10 f 10 1 17 f 15); /* 太いラインの小さなボックス */ 

setlines tyle (saveline.linestyle t /* 元の，イン投定を回復 */ 

8aveline.upattern f 
saveline•thickness); 


getche ()； 



ックス関数 
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getmaxcolor 


機能 setcolor 関数に渡すことができるカラーの最大値を返します。 

形式 # include く graphics . h 〉 

int iar getmaxcolor ( void ) : 


プロトタイプ graphics.h 

解脱 getmaxcolor は，カレントグラフィックスドライバと，カレントグラフィ 

ックスモードにおいて有効なカラーの最大値（ハ•レットサイズ- 1) を返し 
ます。 

PC -9801 では， getmaxcolor は常に15を返し，これは setcolor に渡す数値 
は0から15までが有効であることを意味します。 

IBM PC の場合，たとえば 256 K の EGA では， getmaxcolor は常に15を返 
し，これは setcolor には0から15までの数値を指定できることを意味しま 
す。また， CGA の高解像度モードや Hercules モノクロアダブタでは，0お 
よぴ1のカラーしかサポートしていないため， getmaxcolor は常に1を返し 
ます。 

戻り値 getmaxcolor は使用できるカラーの最大値を返します。 

可撤性 getmaxcolor は PC -9801 シリーズ（または IBM PC とその互換機）でのみ 

動作します （IBM PC では，サポートするグラフィックスディスプレイア 
ダブタを備えていなければなりません）。 

M 連項目 getbkcolor ， getcolor , getpalette ， getpalettesize , setcolor 


542 


第 2 章 Turbo C ライブラリ 



getmaxmode 


機能 カレントドライバで使用できる最大のモード番号を返します。 


形式 # include く graphics . h 〉 

int far getmaxmode ( void ) : 


ブロトタイプ graphics.h 

解脱 getmaxmode は，現在ロードされているドライバで使用可能な煅大のモー 

ド番号を，そのドライバから直接取り出して返します。 getmaxmode は， 
サー ド バーティ が提供するドライバに対しても機能します ( getmoderan - 
ge はデフォルトのドライバに対してしか機能しません）。モードの®:小値 
は0です。 

戻り値 getmaxmode は，カレントドライ八において使用可能なモードの最大値を 

返します。 

可撤性 getmaxmode は PC -9801 シリーズ（または IBM PC とその互換機）でのみ 

動作します （1 BMPC では，サポートするグラフィックスデイスブレイア 
ダブタを備えていなければなりません）。 

M 連項目 getmodename，getmoderange 
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getmaxx 

機能 画面上のズ座標の最大値を返します。 

形式 # include く graphics . h 〉 

int far getmaxx ( void ) : 

プロトタイプ graphics.h 

解脱 getmaxx は，カレントグラフィックスドライバと，カレントグラフィック 

スモードで有効な，ズの最大値（画面に対する相対値）を返します。 
PC -9801 では， getmaxx は常に639を返します。 

IBM PC の場合，たとえば CGA の 320 X 200 モードでは， getmaxx は319を 
返します。 

getmaxx は，センタリングや画面上の領域の境界を決定する際に有用で 


戻り値 getmaxx は，阃面座標におけるズ座標の最大値を返します。 

可搬性 getmaxx は PC -9801 シリーズ（または IBM PC とその互換機）でのみ動作 

します （IBM PC では，サポートするグラフィックスディスプレイアダブ 
夕を備えていなければなりません）。 

関連項目 g ： etmaxy, getx 

例 printfCThe screen resolution is Id pixels by Zd pixels.¥n', 

getmaxx()+ 1 , getmaxy()+ 1 )； 
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getmaxy 


画面上の夕座標の最大値を返します。 


機能 

形式 

プロトタイプ 

解脱 


戻り値 

可搬性 

関連項目 

例 


# include <graphics.h> 
int rar getmaxy (void) : 

graphics.h 

getmaxy は，カレントグラフィックスドライ八と，カレントグラフィック 
スモードで有効な， 夕の最大値 (画面に対する相対値）を返します。 
PC -9801 では， getmaxy は常に399を返します。 

IBM PC の場合，たとえば CGA の 320 X 200 モードでは， getmaxx は199を 
返します。 

getmaxy は，センタリングゃ画面上の領域の境界を決定する際に有用で 
す。 

getmaxy は画面座標における夕座標の煅大値を返します。 


getmaxy は PC -9801 シリーズ（または IBM PC とその互換機）でのみ動作 
します （ IBMPC では，サポートするグラフィックスディスプレイアダブ 
夕を備えていなければなりません）。 


getmaxx , gety 


getmaxx を参照してください 0 


グラフィックス 関数 リファレンス 
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getmodename 


機能 グラフ ィ ックスモード名を t 辱ます。 

形式 # include < graphics . h > 

char * far getmodename (int mode number ) : 

プロトタイプ graphics.h 

解脱 getmodename はカレントグラフイックスドライバの mode number によ 

つて指定されたモードの名前を示す文字列へのポインタを返します。モー 
ド名はドライバごとに組み込まれています。返される値は， メニューを 作 
成したりステータスを表示したりする際に便利です。 

PC -9801 では以下のような文字列が返されます。 


mode number 

文字列 


0 

”640 x 400 PC 9801 

8_ COLOR ” 

1 

”640 x 400 PC 9801 

16- COLOR ” 





戻り値 getmodename はモード名へのポインタを返します。 

可搬性 getmodename は PC -9801 シリーズ（または IBM PC とその互換機）での 

み動作します （ IBMPC では，サポートするグラフィックスディスプレイ 
アダプタを備えていなければなりません）。 

fteii [項目 getdrivername , getmaxmode，getmoderancre 
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getmoderange 


機能 

形式 

プロトタイプ 

解脱 


戻り偭 
可撤性 

間連項目 

例 


指定のグラフィックスドライパで有効なモードの範囲を得ます。 
# include <graphics.h> 

void far getmoderange unt graphdriver, int tar * lomode ， 

int far 本 himode) \ 


graphics.h 

getmoderange は，与えられたグラフィックスドライバ graphdriver に} i 
いて有効なグラフィックスモードの範囲を得ます。許されるモードの最小 
値は* lomode に返され，最大値は* himode に返されます。 graphdriver と 
して無効なグラフィックスドライパが指定されると，* lomode ヒ 
* himode はと もに-1にセットされます。* graphdriver の懷がの場合に 
は，現在ロー ドされているドライバを指定することになります。 

ありません。 


getmoderange は PC -9801 シリーズ（または IBM PC とその互換機）での 
み動作します （ IBMPC では，サボートするグラフィックスディスプレイ 
アダプタを備えていなければなりません）。 


geigraphmode , getmaxmode , getmodename , initcrraph , setgraphmode 


#include <graphics.h> 


main() 

{ 

int lo, hi; 

getmoderange(PC98 f &lo f &hi); 

printfCPC-9801 supports modes Zd through 2d¥n* f lo, hi); 


グラフィックス 関数 リファレンス 
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getpalette 

機能 カレントパレットに関する情報を得ます。 

形式 # include く graphics . h 〉 

void iar getpalette (struct palettetype far * palette ) : 

プロトタイプ graphics.h 

解脱 getpalette は，カレントパレットのサイズと各カラーに関する悄報を， pal ¬ 

ette が指す palettetype 型の構造体に丼き込みます 0 
getpalette で用いられる palettetype 型怫造体と定数 MAXCOLORS は， 
graphics . h の中で次のように定我されています。 

#define MAXCOLORS 15 

struct palettetype { 
unsigned char size; 
signed char colors(MAXCOLORS + 1 】； 

size は ，カレントグラフ イッ クスドライバと，カレントグラフ イッ クスモー 
ドでの， ハ•レット中のカラーの数です。 

colors は， バレ ットの中のそれぞれの項目に対応した実際のカラーの番号 
を要素とする泣どバイトの配列です。 

注意： getpalette は， IBM -8514 ドライバでは使用できません。 

戻り値 ありません。 

可撤性 getpalette は PC -9801 シリーズ（または IBM PC とその互換機）でのみ動 

作します （ IBMPC では，サポートするグラフィックスディスプレイアダ 
ブタを備えていなければなりません）。 

関連項目 getbkcolor ， getcolor , getdefaultpalette , getmaxcolor , 

setallpalette , setpalette 
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例 


#include <graphics.h> 
#include <8tdio.h> 
#include <conio.h> 


main() 

{ 

int graphdriver - DETECT, graphmode; /* 自動検出を要求 */ 

struct palettetype palette ； 
int color ； 


initgraph(igraphdriver f igraphmode, ■_); /* 初期化 */ 

getpalette(fcpalette )； /* カレントバレツトを 得る 

for(color - 0 ； color < palette.size ； color++) 

setfillstyle(S0LID — PILL, color); /* 様々な色のバーを描く 
bar(20*(color-l) f 0 , 20*color f 20 )； 


if (palette.size > 1 ){ /* カラーが複数あれば */ 

d0 , /* キーが押されるまで */ 

8 etpalette(random(palette. 8 i 2 e), random(palette.size )) ； 

/* ，ンダムに切り換える */ 

/* 入力された文字は搶てる */ 


/* パレツトを元に R す */ 




グラフイックス関数リファレンス 
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getpalettesize 

機能 パレットカラー参照テーブルのサイズを返します0 

形式 # include く graphics . h 〉 

int far getpalettesize ( void ) •• 

プロトタイプ graphics.h 

解脱 getpalettesize は，カレントグラフィックスモードで，いくつのパレットが 

設定できるかを得るために使用します。 

PC -9801 では， getpalettesize は常に16を返します。 

IBM PC の場合，たとえば EGA のカラーモードでは16が返されます。 

戻り値 getpalettesize は，カレントパレットの艰目数を返します 0 

可撤性 getpalettesize は PC -9801 シリーズ（または IBM PC とその互換機）での 

み動作します （ IBMPC では，サポートするグラフィックスデイスブレイ 
アダプタを備えていなければなりません）。 

M 連項目 setpalette , setallpalette 
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getpixel 


機能 


指定されたピクセルのカラーを得ます。 


形式 


# include く graphics . h 〉 
unsigned far getpixel (int x . 


フロトタイプ graphics.h 


解脱 


getpixel を使ラと，（ズ,夕）に位 S するビクセルのカラーが得られます, 


戻り値 


getpixel は指定されたビクセルのカラーを返します。 


可搬性 


getpixel は PC-9801 シリーズ（または IBM PC とその互換機）でのみ動作 
します （IBM PC では，サポートするグラフィックスディスプレイアダブ 
夕を備えていなければなりません）。 


関連項目 


getimage , putpixe 里 


例 


/include く graphics.h> 

#include <conio.h> 

main() 

{ 

int graphdriver _ DETECT # graphmode ； /* 自動横出を砰求 */ 

int i 9 color, max; 


initgraph(igraphdriver f &graphmode f ■•)； 
max _ getmaxcolorO + 1 ； 


/* 初期化*/ 


/* ライン上のビクセルのカラーを資化させる */ 

for (i _ 1; i < 200 ； i++) { 
color - getpixel(i, i )； 

〉 putpixel(i, i, (color ^ i) Z max )； 

getche ()； 
closegraphO ； 


グラフイックス関数リファレンス 
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gettextsettings 


機能 現在のグラフィックテキストの設定に関する悄報を返します。 

形式 # include く graphics . h 〉 

void far gettextsettings (struct textsettingstype iar * texttypeinjo ) \ 

プロトタィプ graphics.h 

解脱 gettextsettings は， texttypeinfo が指す textsettingstype 型構造体に，力 

レントテキストフォント，テキストの向き，文字サイズ，位»合わせにつ 
いての悄報 （ settextstyle や 8 ettextjustify でセットされる悄報）を？ f き込 

みます。 

gettextsettings で用いられる textsettingstype 型携造体は， graphics.h 

の中で次のように定義されています。 

struct textsettingstype { 
int font; 
int direction; 
int charsize; 
int horiz; 
int vert; 

> 

各フィールドの意味については settextstyle を参照してください。 

戻り 値 ありません。 

可撤性 gettextsettings は PC -9801 シリーズ（または IBM PC とその互換機）で 

のみ動作します （ IBMPC では，サポートするグラフィックスディスブレ 
イアダプタを備えていなければなりません）。 

閣連項目 outtext , outtextxy ， settextjustify , settextstyle , 

setusercharsize , textheight，textwidth 
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例 


/include く graphics.h> 
#include <conio.h> 


main() 

{ 

int graphdriver _ DETECT, graphmode ； /* 自動棰出を襲求 */ 
struct textsettingstype oldtext ； 

initgraph(&graphdriver f &graphmode t ,# )； /★ 初期化 */ 


gettextsetting 8 (&oldtext)• 


I* 現在の設定を得る */ 


卜 水平方由 • 上左揃えに切り替え 

ゴシックフォント • 因子 5 */ 

settextjustify(LEFT_TEXT f TOP TEXT); 
settextstyle(GOTHIC 一 FONT, HORIZ DIR t 5 )； 
outtext( •Gothic Texf )； 


/* 設定を元に R す */ 

settextju 8 tify(oldtext.horiz f oldtext.vert )； 
settext 8 tyle(oldtext.font, oldtext.direction• 

oldtext.charsize )5 

getche(); 
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getviewsettings 


機能 

形式 

プロトタイプ 

解脱 


戻り値 
可撤性 

関連項目 

例 
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カレントビューボートに関する情報を得ます0 


# include く graphics . h 〉 

void far getviewsettings^struct viewporttype far * viewport ) : 
graphics.h 

getviewsettings は， v / Vvvpor / が指す viewporttype 型構造体に，カレント 
ビューボートに関する悄報を#き込みます。 

getviewport が用いる viewpoint 胡擠造体は， graphics . h の中で次のよう 
に定我されています。 


struct viewporttype { 

int left f top, right f bottom; 
int clipflag ； 

> 

ありません。 

getviewsettings は PC -9801 シリーズ（または IBM PC とその互換機）で 
のみ動作します （ IBMPC では，サポートするグラフィックスデイスブレ 
イアダプタを備えていなければなりません）。 


clearviewpori , getx , gety , setviewpori 
struct viewporttype view; 



if ( 1 view.clip) 


/* 現在の » 定を得る */ 

/* クリッピングがオフであれば */ 


setviewport(view.left , view.top, 

view.right f view.bottom,1) : 


/* オンにする */ 
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getx 


機能 


現在位置の X 座標を返します, 


形式 


# include < graphics . h > 
int far getx ( void ) : 


ブロトタイプ graphics.h 


解説 


getx は，現在位 0 B のズ座標を返します。返される値はビューポート相対で 
す0 


戻り値 


getx は， CP のズ座標を返します< 


可撤性 


getx は PC -9801 シリーズ（または IBM PC とその互換機）でのみ動作しま 
す （IBM PC では，サポートするグラフィックスディスプレイアダプタを 
備えていなければなりません）。 


関連項目 


getmaxx , getmaxy , getviewsetting ^ gety 


例 int oldx f oldy; 

/* カレント位置をセーブ */ 
oldx _ getx(); 
oldy _ gety(); 

circle(100 f 100 • 2>; /* 【 100,100 】に小さな丸を搐 く */ 

moveto( 99 f 100 )； 
linerel( 2 , 0 ) ； 

moveto(oldx ， oldy )； /* 元の位置に霣る */ 
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gety 


機能 现在位 s の夕座標を返します。 

形式 # include く graphics . h 〉 

mt far gety ( void ) : 

プロトタイプ graphics.h 

解脱 gety は，现在位 S の夕座標を返します。返される値はビューポート相対で 

す。 

戻り値 gety は， CP の夕座標を返します。 

可搬性 gety は PC -9801 シリーズ（または IBM PC とその互換機）でのみ動作しま 

す （IBMPC では，サポートするグラフィックスディスプレイアダプタを 
備えていなければなりません）。 

閭連項目 getmaxx , getmaxy , getviewsettings , getx 

例 Retx を参照してください。 
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graphdefaults 


機能 


形式 


グラフイックスのすべての設定をデフォルトにリセットします。 

# include < graphics . h > 
void far graphdefaults ( void ) : 


プロトタイプ graphics.h 


解脱 


graphdeiaults は，あらゆるグラフィ ッ クスの設定をデフォルトにリセ ッ 
卜します。これは以下の動作を意味します。 


I ビューボートをスクリーン全体に設定する。 

I カレント座標を （0,0) に動かす。 

I デフオルトのハ。レツトカラー，ハ•ックグランドカラー，ドロウカラ 
をセットする。 

デフオルトのフイルスタイルとフイルハ•ターンをセットする 
デフオルトのテキストフォントと位 K 合わせをセットする。 


戻り値 


ありません。 


可撤性 


関連項目 


graphdefaults は PC -9801 シリーズ（または IBM PC とその互換機）での 
み 動作し ます （ IBMPC では，サポートするグラフィックスディスプレイ 
アダブタを備えていなければなりません）。 

initgraph 


グラフイツクス関数リファレンス 
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grapherrormsg 

機能 エラーメッセージ文字列へのポインタを返します。 

形式 林 include く graphics . h 〉 

char * far grapherrormsg (int error code ) : 

プロトタイプ graphics.h 

解脱 grapherrormsg は， graphresult が返した エラーコードに 対応す るエラー 

メッセージ文字列を指すポインタを返します。 

errorcode の値と対応する文字列については， graphresult の解説を参照し 
てください。 

戻り値 grapherrormsg は，エラーメッセージ文字列を指すボインタを返します 0 

可撤性 grapherrormsg は PC -9801 シリーズ（または IBM PC とその互換機）で 

のみ動作します （IBM PC では，サポートするグラフィックスディスブレ 
イアダプタを備えていなければなりません）。 

関連項目 graphresult 
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一 graphfreemem 


グラフイ ツ クスメモリの解放ルーチンへの フッ クです。 


形式 


# include < graphics . h > 

void far _ graphfreemem(void far * ptr , unsigned size ) 


ブロトタイプ graphics.h 


クラフィックスライブラリ中のルーチンは， graphfreemem を呼び出し 
て，前に— graphgetmem を使って割り当てたメモリを解放します。 ユーザ 
独目の一 graphfreemem のバージョンを定我すれば（これは上の宣言通り 
に正確に宣言しなければいけません），グラフィックスライブラリのメモリ 
管理の方法を変更することができます。デフォルトバージョンでは，この 
ルーチンは free を呼び出すだけです。 


戻り値 


ありません。 


可搬性 


jraphfreemem は PC -9801 シリーズ（または IBM PC とその互換機）で 
のみ動作します （IBM PC では，サポートするグラフィックスディスブレ 
イアダブタを備えていなければなりません）。 


M 連項目 


graphgetmem , setgraphbufsize 


グラフイツクス M 数リファレンス 
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例 


/* ユーザ定義のグラフイツクスメモリ管理ルーチンの倒 */ 


include <graphics.h> 
include <stdio.h> 
include <conio.h> 


include <process.h> 
include <alloc.h> 


main() 

{ 

int errorcode ； 
int graphdriver ； 
int graphmode; 


graphdriver - DETECT; 

initgraph(igraphdriver f igraphmode, .a:¥¥•>; 
errorcode _ graphresult(); 
if (errorcode l_ grOk) 

{ 

printf(•graphics error : 28¥n* f grapherrormsg(errorcode ))； 
exit ⑴； 


settextstyle(GOTHIC 一 FONT. HORIZ_DIR t 4); 
outtextxy(100 f 100 f *BGI TEST*)7 
getcheO ； 
closegraph ()； 


void far *far _graphgetmem(un8igned size) 


printf(•_graphgetmem called 
getch() 5 printf(•¥!!•); 



[ 8ize-IdJ -- hit any key* f size) : 

/* far ヒープを使用 */ 


void far _graphfreemem(void far *ptr f unsigned size) 

{ 

printf( - _graphfreemem called [size-Zd) — hit any key' size); 
getchO; printf (*¥n) i 

farfree(ptr )； /* size は使われない */ 
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-graphgetmem 


形式 


グラフイックスメモリの割り当てルーチンへのフック です 

# include <graphics.h> 

void far * far —graphgetmem (unsigned size) \ 


ブロトタイプ graphics.h 


解脱 


戻り値 


クフフィックスライブラリ中のルーチンは • 通常 graphgetmem を呼び出 
して，内部バッファ，グラフィックスドライハ' 文字セットの ためのメモ 
リを割り当てます （ raphgetmem を呼び出すのはライブラリルーチンブ- 
あリ ，ユーザブロ グラムではありません） 。ユーザ 独自の _ graphgetmem を 
定我すれば（形式に示されているとおりに正確に宣言しなければいけ ませ 
んが)，グラフィックスライブラリのメモリ管理の方法を変更する ことが で 
きます。デフオルトでは，このルーチンは malloc を呼び出すだけです。 

ありません。 


可撤性 


_ gra P ng ： e tin e in は PC-9801 シリーズ（または IBM PC とその互換機）での 
み動作します （IBMPC では，サポートするグラフィックスディスプレイ 
アダプタを備えていなければなりません）。 


間連項目 — graphfreemem , initgraph , setgraphbufsize 


一 graphfreemem を参照してください, 


グラフイ ツ クス 閫数リ ファレンス 
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graphresult 


機能 失敗した最後のグラフイックス操作に対するエラーコードを返します。 

形式 # include <graphics.h> 

int far graphresult(voia )； 



grapnics.h 

graph result は，エラーとなった®後のグラフィックス操作に対するエラ 


ーコードを返し，エラーレベルを grOk にリセットします。 


次の表は， graphresult が返すエラーコードを示しています。この表の中の 


定数は， graphics.h の中で列挙型^ jp/i/cs errors と して定義されていま 


す 0 


エラー graphics—errors 対応するエラーメッセージ文字列 

コード定数 /意味 

0 grOk No error 

エラーなし 

-1 grNoInitoraph (Bui) graphics not installed (use ini い 

graph ) 

(BGI) グラフィックスが組み込まれてい 

ない （ initgraph を使用せよ） 

-2 gr Not Detected uraphics hardware not detected 

グラフィックスハードウヱアが検出でき 
ない 

-3 grrileNotFound Device driver file not found 

デバイスドライバフアイルがみつからな 
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grlnvalidDriver 


Invalid device driver fi 

デバイスドライバファイ 


-5 

grNoLoadMem 

Not enough memory to 
ドライバをロー ドするメ q 

-6 

grNoScanMem 

Out of memory in scan 

スキャンフイルでメモリ 

-7 

grNoFloodMem 

Out of memory in flood 
フラッドフイルでメモリカ 

-8 

grFontNotFound 

Font file not found 

フォントフアイルがみつ力 

-9 

grNoFontMem 

Not enough memory to 

フォントをロー ドするメそ 

-10 

grlnvalidMode 

Invalid graphics mode 

driver 

選んだドライバに対してク 

モードが正しくない 

-11 

grError 

uraphics error 

-12 

KrlOerror 

グフフイックス エラー 

1 TranhirQ I/O ^rrr\r 



graphresult が呼び出されると，エラー コー ドは 〇 にリセットされることに 
注意してください。したがって， graph result が返した値をいったん変数に 
代入してからテストすべきです。 


グラフイ ツ クス閧数リファレンス 
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戻り値 


可搬性 


関連項目 
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graphresult は，現在のグラフ ィック スエラー番号，すなわち -18 〜〇の範囲 
の整数を返します。 grapherrormsg を使うと， graphresult が返したエラ 

ーコードに対応するエラーメッセージ文字列を指すポインタを得ることが 
できます。 


graphresult は PC -9801 シリーズ（または IBM PC とその互換機）でのみ 
動作します （IBM PC では，サポートするグラフィックスディスプレイア 
ダブタを備えていなければなりません）。 


detectgraph , drawpoly , fillpoly , ftoodfilL grapherrormsg , 
initgraph ， pieslice , registerbgidriver ， registerbgifont ， 
setallpaiette . setcolor , setfillstyle , setgraphmode , 
setlinestyle ， setpaiette ， settextjustify , settextstyle , 
setusercharsize , setviewport , setvisualpage 
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imagesize 


機能 ビットイメージの格納に必要なバイト数を返します。 

形式 # include く graphics.h 〉 

unsigned rar imagesize(int left 、int top 、int right, int bottom ) : 

プロトタィプ graphics.h 

解脱 imagesize は， getimage によってビットイメージを格納するのに必要な 

メモリ領域のサイズを決定します。返されるバイト数には，イメージの幅 
と商さのためのメモリ領域も含まれています。選んだイメージに対して必 
要となる大きさが 64K-1 バイト以上の場合， imagesize は OxFFFF (-1 ) を 
返します。 

戻り値 imagresize は，必要とされるメモリ領域のサイズをバイト単位で返します。 

可搬性 ！ 111 狀 8 以は？ ( ： .9801 シリーズ（または 1151\4? 〇とその互換機）でのみ動作 

します （IBM PC では，サポートするグラフィックスディスプレイアダブ 
夕を備えていなければなりません）。 

間連項目 ^etimage, putimag：e 
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initgraph 

機能 グラフィックスシステムを初期化します。 

形式 # include く graphics . h 〉 

void far initgraph(mt tar * graphdriver , int far * graphmode ， 

char far * pathtodriver ) \ 

プロトタイプ graphics.h 

解脱 initgraph は，ディスクからグラフィックスドライバをロー ド（もしくは登 

録されているドライバを有効に）し，システムをグラフィックスモードに 
して，グラフィックスシステムを初期化します。 

グラフィックスシステムを起動するには，まず最初に initgraph を呼び出 
します。 initgraph は，グラフイックスドライパを口ードし，システムをグ 
ラフィックスモードにします。 initgraph には，特定のグラフィックスドラ 
イバおよびモードを指定することができます。あるいは，実行時にハード 
ウェァを調べて自動的に®:適なドライバをロー ドするように指示すること 
(自動検出）もできます。 

自動検出を指示すると， initgraph はグラフィックスドライバとモードを 
選択するために detectgraph を呼び出します。 initgraph はさらに，すべて 
のグラフィックスの設定（現在位置，パレット，カラー，ビューボートな 
ど）をデフォルトにセットし ， graph result を0にリセットします。 

通常 initgraph は （ graphgetmem を使って）ドライバに必要なメモリを 
割り当て，ディスクから .BGI ファイルを読み込むことによって，グラフィ 
ックスドライバをロー ドします。このように動的にロー ドする方法の他に, 
グラフイックスドライハ•ファイル（場合によってはそのいくつか）を実行 
可能ブログラムファイルに直接リンクする方法があります（この詳細にっ 
いてはユーザーズガイド付録 C の BGIOBJ の節を参照してください）。 
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pathtodriver [こ \ initgraph がグラフィックスドライパを探索するディレ 
クトリパスを指定します。 initgraph は，まず par/itodriver で指定されたパ 
スで探索を行ない，（グラフィックスドライ八がそこになければ)次にカレ 
ントディレクトリで探索を行ないます 0 したがって， pathtodriver が NULL 
であると，ドライバファイル （*. BGI ) はカレントディレクトリになけれ 
ばなリません。このバスは， settextstyle がストローク文字フォントファイ 
ル （*. CHR ) を探索するパスでもあります。 

* graphdriver は ，使用されるべきグラフィックスドライバを指定する整 
数です。この値には， graphics.h に定義されている次の表に示す列挙型 
graphics drivers 中の定数を使うことができます。 


graphics drivers 定数 


DETECT 
CGA 
MCGA 
EGA 
EGA 64 
EGAMONO 
IBM 8514 
HERCMONO 
ATT 400 
VGA 
PC 3270 
PC 98 

PC 98 GRCG 
PC 98 EGC 


数値 

0 (自動検出要求) 
1 
2 

3 

4 

5 

6 

7 

8 

9 

10 

11 ( PC -9801 のみ） 

12 ( PC -9801 のみ） 

13 ( PC -9801 のみ） 
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* graphmode 1±， 初期グラフィックスモードを示す整数です（ただし， 

* graphdriver が DETECT に等しい場合には ， * graphmode は initgraph 
によって，検出されたドライバにおいて妓も高い解像度が得られるモード 
にセットされます）。* grflpAmo みには， graphics.h で定義されている以下 
のような列挙型 graphics modes の定数を与えることができます。 


ドライバ 

grapmcs modes 

値 

横 x 縦 

パレツ 

PC98 

PC98C8 

0 

640 x 400 

8色 


PC98C16 

1 

640 x 400 

16色 

PC98GRCG 

PC98C8 

0 

640X400 

8色 


PC98C16 

1 

640 X 400 

16色 

PC98EGC 

PC98C8 

0 

640X400 

8色 


PC98C16 

1 

640X400 

16色 

CGA 

CGACO 

0 

320 x 200 

C0 


CGAC1 

1 

320X200 

C1 


CGAC2 

2 

320X200 

C2 


CGAC3 

3 

320X200 

C3 


CGAHI 

4 

640X200 

2色 

MCGA 

MCGACO 

0 

320X200 

C0 


MCGAC1 

1 

320 x 200 

C1 


MCGAC2 

2 

320X200 

C2 


MCGAC3 

3 

320X200 

C3 


MCGAMED 

4 

640X200 

2色 


MCGAHI 

5 

640 x 480 

2色 

EGA 

EGALO 

0 

640X200 

16色 


EGAHI 

1 

640X350 

16色 
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EGA64 

EGA64LO 

0 

640X200 

16 色 


EGA64HI 

1 

640 x 350 

4 色 

EGAMONO EGAMONOHI 

3 

640 x 350 

2 色 


EGAMONOHI 

3 

640 x 350 

2 色 

HERC 

HERCMONOHI 

0 

720 X 348 

2色 

ATT 400 

ATT400C0 

0 

320X200 

C0 


ATT400C1 

1 

320X200 

Cl 


ATT400C2 

2 

320 x 200 

C2 


ATT400C3 

3 

320 x 200 

C3 


ATT400MED 

4 

640X200 

2 色 


ATT400HI 

5 

640 x 400 

2 色 

VGA 

VGALO 

0 

640 X 200 

16 色 


VGAMED 

1 

640 X 350 

16色 


VGAHI 

2 

640 x 480 

16色 

PC3270 

PC3270 

0 

720 x 350 

2色 

IBM8514 

IBM8514HI 

0 

640 x 480 

256色 


IBM8514LO 

1 

1024X768 

256色 


* 64K EGA モノカード 

* * 256K EGA モノ カード 



1 * 
2 * * 






注意.* graphdriver と* graphmode には，上の表の中から有効な値を指 
定しなければなりません。そうしないと期待通りの結果が得られないこと 
があります。唯一の例外は* graphdriver = DETECT の場合です。 
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戻り値 


可搬性 


上の表中の CO , Cl . C 2 および C 3 は ， CGA (およびその互換）システムで 
使用できる4つの定義済みの4色のバレットを参照しています。これらのパ 
レットではバックグラウンドカラー（項目# 1) のみが指定可能で，他の力 
ラーは固定です。この点の詳細については，ユーザーズガイド第8章の 
「IBM PC CGA でのカラー制御 j の節で述べられていますが，次の表に 
まとめだけを示します。 


カラー番号（ビクセル値）に割り当てられている定数 


パレッ1 

•番号 1 

2 

3 

0 

CGA LIGHTGREEN CGA LIGHTRED 

CGA YELLOW 

1 

CGA 一 LIGHTCYAN 

OGA LCmviAGENTA CGA 一 WHITE 

2 

CGA_GREEN 

CGA RED 

CGA BROWN 

3 

CGA_CYAN 

CGA_MAGENTA 

CGA_LIGHTGRAY 


inits ： raph を呼び出すと，* graphdriver はカレントグラフィックスドライ 
バに，* graphmode はカレントグラフィックスモードにセットされます。 

initgraph は，常に内部エラーコードをセットします。成功した場合，エラ 
ーコードには0がセットされます。エラーが発生した場合は，* graphdriver 
は-2, -3， -4, あるいは -5 にセットされ， graphresult も同じ値を返しま 
す。各値は次のような意味を持ちます。 

-2 グラフィックスカードが検出できない 

-3 ドライバファイルを検出できない 

-4 ドライバが正しくない 

-5 ドライパをロー ドするためのメモリが足りない 


initgraph は PC -9801 シリーズ（または IBM PC とその互換機）でのみ 動 
作します （IBM PC では，サポートするグラフィックスディスプレイアダ 
ブタを備えていなければなりません）。 
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関連項目 


closegraph , detectgraph , getdefaultpalette ， getdrivername ， 
getmoderange , graphdefaults , graphgetmem ， graphresult , 
installuserdriver , registerbgidriver , registerbgifont ， 
restorecrtmode f setgraphbufsize , setgraphmode 

例 /include く graphics.h> 

#include <stdio.h> 

#include <conio.h> 

#include <proce88.h> 

main() 

{ 

int g 一 driver• g_mode t g_error; 
detectgraph(fcg_driver f 4g_mode )； 
if (g_driver < 0) 

{ 

printf("No graphics hardware detected !¥n); 

exit(l ) 5 


printf(•Detected graphics driver #Zd 9 mode #Zd¥n B f 
g 一 driver, g 一 mode); 
getch(); 

if (gjnode __ EGAHI) 

I* override mode if EGA detected */ 
g_mode ■ EGALO; 

initgraph(ig_driver f &g_mode, ••); 
g 一 error _ graphresult()5 

if (g_error < 0) 

{ 

printf("initgraph error ： Is.¥n # f grapherrorm8g(g_error))5 
exit(l) 5 


bar(0. 0. getmaxx()/2 f getmaxyO )； 

getch(); 

closegraphO; 


グラフイックス 関数 リファレンス 
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installuserdriver 


機能 BGI デバイスドライ八テーブルに，サードハ •ー ティ提供のデバイスドライ 

ハーをインストールします。 

形式 # include く graphics.h 〉 

int far installuserdriver (char far * name, int huge (本 detect) (void)) : 

プロトタイプ graphics.h 

解脱 installuserdriver を使用すると，サードハ •ー ティ供給のデバイスドライバ 

を， BGI の内部テーブルに追加することができます。引数は新しい 
デバイスドライバファイル (. BGI ) の名前です。引数み/江/はオプション 
で，新しいドライバについてくる場合がある自動検出問数を指すポインタ 
です。この自動検出関数は引数を持たず，関数値として祭数を返します。 
このサードハ•ーティ供給ドライバの使う方法は2つあります。たとえば，い 
ま Spiffy Graphics Array ( SGA ) という新しいグラフ ィッ クボードを眯入 
し， SGA の製造元から BGI デバイスドライハ •（ SGA . BGI ) も供給された 
としましよう。このドライバを使う股も簡単な方法は，まず instalhiser - 
driver を呼び出してこれをインストールし，その戻り値（割り当てられた 
ドライバ番号）を直接 initgraph に渡すというものです。 

もう1つは，より一般的で， initgraph によってハードウェァ検出ロジック 
の一部として呼び出される自動検出関数（おそらく SGA の供給元はこの 
自動検出関数をつけてくるはずです）をリンクするという方法です。ドラ 
イバを （ installuserdriver を呼び出して）インストールする際に，デバイ 
スドライバフアイルの名前とともにこの関数のアドレスを引数として渡し 
ます。 
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デバイスドライハ•ファイル名と SGA 自動検出関数をインストールした後 
は， initgraph を呼び出して通常の自動検出ブロセスを行なわせます。 init - 
graph は，組み込みの自動検出関数 ( detectgraph ) を呼び出す前に ， SGA 
自動検出関数を呼び出します。 SGA 自動検出関数が SGA ハードウエアを 
見つけられなかった場合は-11 ( grError ) を返し， initgraph は引き統いて 
通常のハードウエア検出ロジックを呼び出します（他にもサードハ •ー ティ 
提供の自動検出関数が存在する場合は，それらもインストールされた順で 
呼ばれます)。自動検出関数は， SGA が存在すると認識した場合，負でない 
モード番号を返し， initgraph はその値を用いて SGA . BGI を見つけて口 
ードし，ハードウエアを自動検出関数が推奨するデフォルトのグラフ ィッ 
クスモードにして， S 後に制御をユーザブログラムに戻します。 

一度に10個までのドライバをインストールすることができます。 

戻り値 installuserdriver によって返される値は， initgraph が新しくインストー 

ルされた ドライバを選択させるために渡すドライバ番号です。 

可搬性 installuserdriver は PC -9801 シリーズ（または IBM PC とその互換機）で 

のみ動作します （ IBMPC では，サボートするグラフィックスディスブレ 
イアダプタを備えていなければなりません）。 

間連項目 initgraph , re^isterbgidriver 


グラフイックス 関数 リファレンス 
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installuserfont 


機能 BGI システムには組み込まれていないフォントフアイル （. CHR ) をロード 

します。 


形式 # include く graphics . h 〉 

int lar installuserfont (cnar far 本 name ) : 

プロトタイプ graphics.h 

脱明 は， ストロークフォント を含む フォン ト ファイルへのバス 名です。 一 

度に20個までのフォントをインストールすることができます。 

戻り値 installuserfont は， settextstyle が対ぽするフォントを選べるように渡す 

フォント ID 番号を返します。内部フォントテーブルがいっぱいになって 
いる場合は， -11( grError ) を返します 0 

可撤性 installuserfont は PC -9801 シリーズ（または IBM PC とその互換機）での 

み動作します （ IBMPC では，サポートするグラフィックスディスブレイ 
アダプタを備えていなければなりません）。 

M 連項目 settextstyle 


グラフィックス 関数 リファレンス 
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line 


機能 2 点を結ぶ直線を描きます。 

形式 # include <graphics.h> 

void far line (int パ， int yl % int x 2 % int y 2) \ 

ブロトタイプ graphics.h 

解脱 line は，カレントカラー，ラインスタイルおよひ•ライン幅を用いて，カレ 

ント位逋 ( CP ) を変更せずに，指定された2点 ( xl ， yJ ) と ( x 2 t y 2 ) を結ぶ 
直線を描きます。現在位 K ( CP ) は更新されません。 

戻り値 ありません。 

可搬性 line は PC -9801 シリーズ（または IBM PC とその互換機）でのみ動作しま 

す （IBM PC では，サポートするグラフィックスディスプレイアダプタを 
備えていなければなりません）。 

W 連項目 linerel ， lineto , setcolor , setlinestyle , setwritemode 
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linerel 


機能 

形式 

プロトタイプ 

解脱 

戻り値 
可搬性 

M 連項目 


現在位置 ( CP ) から相対距離で直線を描きます。 

# include <graphics.h> 

void far linerel (int dx % int dy ) \ 

graphics.h 

linerel は， CP から， CP との相対距離 ( dx . dy ) である点への直線を描き 
ます。 CP は ( dx . dy 、 だけ移動します。 

ありません。 

linerel は PC -9801 シリーズ（または IBM PC とその互換機）でのみ動作し 
ます （IBM PC では，サボートするグラフィックスディスプレイアダプタ 
を備えていなければなりません）。 

line , uneto ， setcolor , setlinestyle , setwritemode 


グラフィックス 関数 リファレンス 
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lineto 


機能 CP から （ x , y ) への直線を描きます。 

形式 # include く graphics . h 〉 

void far lineto unt x % mt y ) : 

プロトタイプ graphics.h 

解脱 lineto は， CP から ( x t y ) への直線を描き， CP を ( x t y ) に動かします。 

戻り値 ありません。 

可搬性 lineto は PC -9801 シリーズ（または IBM PC とその互換機）でのみ動作し 

ます （IBM PC では，サポートするグラフィックスディスプレイアダプタ 
を備えていなければなりません）。 

閱連項目 line, linerel, setcolor, setlinestyle. setvisualDag：e, setwritemode 


578 


第 2 章 Turbo C ライブラリ 




moverel 


機能 

形式 

解脱 
戻り値 
可撤性 

M 連項目 


現在位 as (cp) を相対距離で動かします。 

# include <graphics.h> 

void far moverel unt ax y int dy) \ 

moverel は，現在位逋 （ CP ) を； c 方向にめ:，夕 方向に dy 移動します。 
ありません。 

moverel は PC -9801 シリーズ（または IBM PC とその互換機）でのみ動作 
します （ IBMPC では，サポートするグラフィックスディスプレイアダブ 
夕を備えていなければなりません）。 

moveto 


グラフィックス 関数 リファレンス 
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moveto 


機能 現在位 ( CP ) を ( x t y ) に移動します。 

形式 # include く graphics . h 〉 

void far moveto (int x t int y ) : 

プロトタイプ graphics.h 

解脱 moveto は，现在位 S ( CP ) を与えられた位 iff ( x . y ) に移動します。 

戻り値 ありません。 


可撤性 


moveto は PC -9801 シリーズ（または IBM PC とその互換機）でのみ動作 
します （IBM PC では， 

夕を備えていなければ 



outtext 


機能 

形式 

プロトタイプ 

解脱 


戻り値 
可搬性 

閣連項目 


ビューポート内に文字列を表示します。 


# include く graphics . h 〉 

void far outtext (char far * textstnng ) \ 

graphics.h 

outtext は，ビューポート内で現在設定されている位; S 合わせ，フォント, 
方向，大きさを使用して文字列を表示します。 

outtext は，与えられた文字列 textstring を CP に 表示します。テキストの 
水平方向の桁揃えの設定が LEFT _ TEXT で，またテキストの方向が 
HORIZ DIR の場合， CP のズ座捸は textwidth ( textstring ) だけ增加しま 
す。そうでない場合は CP は変化しません。 

何神頌もフォントを用いる場合，コードの互換性を保つためには，関数 
textwidth , textheight を用いて文字列の大きさを決定してください。 


注意： outtext を使ってデフォルトフォントで文字列を # f く場合，カレン 
トビューポートの外へはみだしてしまう部分は出力されません。 

注意： outtext は，グラフィックスモードでのみ使用できます。テキストモ 
ードでは使用できません。 

ありません。 

outtext は PC -9801 シリーズ（または IBM PC とその互換機）でのみ動作 
します （ IBMPC では，サポートするグラフィックスディスプレイアダプ 
夕を備えていなければなりません）。 

getiextsettings , outtextxy ， settextjustify , settextstyle , 
textheig ： ht , textwidth 


グラフイックス関数リフアレンス 
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outtextxy 


機能 指定した位 s に文字列を表示します。 

形式 # include < graphics . h > 

void far outtextxy (int x , int y , char far * textstring ) \ 

プロトタイプ graphics.h 

解脱 outtextxy は，ビューボート内で現在設定されている位*合わせ，フォン 

卜，方向，大きさを使用して，文字列を与えられた位 S UjO に表示しま 
す。 

何神類もフォントを用いる場合，コードの互換性を保つためには，関数 
textwidth ， textheight を用いて文字列の大きさを決定してください。 

注意： outtextxy を使ってデフォルトフォントで文字列を# く場合，カレ 
ントビューボートの外へはみだしてしまう部分は出力されません。 

注意： outtextxy は，グラフィックスモードでのみ使用できます。テキスト 
モードでは使用できません。 

戻り値 ありません。 

可搬性 outtextxy は PC -9801 シリーズ（または IBM PC とその互換機）でのみ動 

作します （ IBMPC では，サポートするグラフィックスディスプレイアダ 
ブタを備えていなければなりません）。 

M 連項目 gettextsettings , outtext , textheight，textwidth 
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pieslice 


機能 パイスライス（扇形）を描いて，その中をフィルします。 

形式 # include <graphics.h> 

void far pieslice (int x, int y % int stangle , int endangle , int radius ) : 

プロトタイプ graphics.h 

解脱 pieslice は，中心が(ズ，夕)，半径が m ゴ/⑽の扇形を描いて，その中をフィ 

ルします 0 域形の妈度 M stang 丨 e から endangie までです。 M 形の輪郭を力 
レントドロウカラーで描き，カレントフイルバターンとフイルカラーで中 
をフィルします。 

pieslice の角度は，反時計まわりで，0度が時計で3時の方向，90度が12時の 
方向です。 

注意 [IBM PC ] : CGA のハイレゾリユ ー シヨンモード，あるいはモノクロ 
グラフ イッ クスアダプタを使用している場合，この マニュアル にあるサン 
ブルブログラムは期待通りに動かないことがあります。 CGA のハイレゾリ 
ユーシヨンモードまたはモクロアダプタを使っている場合は，フィルカラ 
一あるいはドロウカラーを セッ トする関数 （ setcolor , setfillstyle , set - 
linestyle など）には，シンボリック定数を使わずに，値1を渡すようにして 
ください。 arc 関数の 例 2で, CGA あるいはモノクロアダブタ上で pieslice 
をどのように使うかを示しています。 

戻り偭 ありません。 

可搬性 pieslice は PC -9801 シリーズ（または IBM PC とその互換機）でのみ動作 

します （ IBMPC では，サボートするグラフィックスディスプレイアダブ 
夕を備えていなければなりません）。 

関連項目 fillellipse , graphresult , sector , setfillstyle 


グラフイ ッ クス閲数リファレンス 
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例 


arc を参照してください。 
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putimage 



プロトタイプ graphics.h 





putimage は， getimage によって以前にセーブされたビットイメージを画 
面上に復元します。イメージの左上隅は [left 、 top 、 につかれます。 bitmap 
は，ビットイメー ジが格納されているメモリ内の領域を指します。 

リI数印は，画面上のピクセルのカラーの計切:で行なわれる演荪の神類を 
指定します。この?•寅算は画面上に既にあるピクセルとそれに対応する メモ 
リ内のピクセルに基づ v 、て行われます。 

graphics.h で定義されている putimage ops テーブルにこれらの演苒の名 
前が与えられています。 


機能脱明 


COPY PUT 
XORPUT 
OR PUT 
AND PUT 


NOT PUT 


コピー 

排他的論理和 
論理和 
論理憒 



COPY 一 PUTS, ソースビットマップイメージを画面上に単にコピーしま 

す。 

XOR 一 PUT は，ソースイメージと画面上のイメ —ジとの xor をとりま 

す。 

OR_PUT は，ソースイメージと画面上のイメージの OR をと/1古す 


グラフイツクス閫数リファレンス 
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以下同様です。 


戻り値 ありません。 

可搬性 putimage は PC -9801 シリーズ（または IBM PC とその互換機）でのみ 動 

作します （IBM PC では，サポートするグラフィックスディスプレイアダ 
ブタを偏えていなければなりません）。 

項目 getimag ： e ， imagesize , putpixel , setvisualpage 

例 getimage を参照してください。 
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putpixel 


機能 指定された点のピクセルをプロットします。 

形式 林 include < graphics . h > 

void far putpixel (int ズ， int 夕 • int color ) : 

プロトタイプ graphics.h 

解脱 putpixel は， color で定莪される カラーで ( x t y ) に点を描きます。 

戻り値 ありません。 


可撤性 


putpixel は PC .9801 シリーズ（または IBM PC とその互換機）でのみ動作 
します （IBM PC では，サポ 
夕を備えていなければなりま 


閻連項目 getpixel , putimage 


グラフィックス 関数 リファレンス 


rectangle 


機能 

形式 

プロトタイプ 

解説 

戻り値 
可撤性 

間連項目 

例 
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長方形を描きます。 


# include く graphics.h 〉 

void iar rectangle(int left 、int top, int right, int bottom) \ 
graphics.h 

rectangle は，カレントラインスタイル，ライン幅，カラーを使用して長方 
形を描きます。 

(/ e / ぺ師)は鉍方形の左上隅を，（吩 Ar 加 mw ) は右下隅を指定します。 

ありません。 

rectangle は PC -9801 シリーズ（または IBM PC とその互換機）でのみ動 
作します （IBM PC では，サポートするグラフィックスディスプレイアダ 
ブタを備えていなければなりません）。 


bar ， bar 3 d , setcolor , setlinestyle 


int i ; 

for ( i - 0 ; i <10； i ++) 

rectangle(20-2*1 9 20-2*1 f 10*(i+2) f 10*(i+2))5 
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registerbgidriver 


機能 ユーザがロー ドした，あるいはリンクされているグラフィックスドライバ 

コードをグラフ ィッ クスシステムに登録します。 

形式 # include <graphics.h> 

int registerbgidriver (void (* driver) (void )) : 

プロトタイプ graphics.h 

解脱 registerbgidriver によって， ユーザが ドライ 八フ ァイルを 口ー ドして そ 

のドライパを登録することができます。ドライバのメモリ位置が register - 
bgidriver に渡されていれば, initgraph はその登録されたドライバを使用 
します。ユーザが登録するドライバは，ディスクからヒーブ上に口ードす 
るか， ( BINOBJ . EXE を使って） • OBJ ファイルに変換して. EXE ファイル 
にリンクすることができます。 

registerbgidriver を呼び出すと，グラフ ィッ クスシステムにリンクされる 
べきドライパが存在することを知らせることになります。このルーチンは， 
そのドライバに対するリンクされるべきコードをチェックし，コードが正 
しい場合は内部テーブルに登録します◊リンクされるドライ八に関しては， 
ユーザーズガイド付録 C の 「 BGIOBJ 」 の節で詳しく説明されています。 
registerbgidriver の呼び出しでリンクされるドライ八の名前を使用する 
と，コンパイラ（およびリンカ）に，そのバブリック名でオブジェクトフ 
ァイルをリンクするよう指示することになリます。 

戻り値 registerbgidriver は，指定されたドライ八が正しくない場合は，負のグラ 

フ ィッ クスエラーコードを返します。そうでない場合は，内部ドライ八番 
号を返します。 

ユーザ供給のドライ八を登録する場合は， registerbgidriver が返した値 
を，使用するドライ八番号として initgraph に渡さなければなりません。 


グラフイックス M 数リファレンス 
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可搬性 


関連項目 

例 


registerbgidriver は PC-9801 シリーズ（または IBM PC とその互換機） 
でのみ動作します （ IBMPC では，サポートするグラフィックスディスブ 
レイアダプタを備えていなければなりません）。 


graphresult, initgraph ， installuserdriver, re^isterbRifont 


I* PC-9801EGC ドライバを * 鎌 */ 

if (reg8terbgidriver(PC98BGC driver) <0) ezit(l); 
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registerbgifont 


機能 

形式 

プ a トタイプ 

解脱 


戻り値 

可撤性 

関連項目 

例 


リンクされるストロークフォントコードを登録します 0 

# include <graphics.h> 

int registerbgifont(void ( * font) (void)) : 


graphics.h 


registerbgifont の呼ひ•出しは，/⑽ M こよって指されるフォントがリンク 
時に取り込まれていることをグラフ ィ ックスシステムに知らせます。 

このルーチンは，指定されたフォントに対するリンクされたコードをチェ 
ックし，コードが正しい場合はその内部テーブルに登録します。リンクさ 
れるフォントに関しては，ユーザーズガイド付録 C の 「 BGIOBJ 」 の節で 
詳しく説明されています。 

registerbgifont を呼び出すときにリンクされるフォントの名前を使用す 
ると，コンパイラ（あるいはリンカ）に，そのハ•ブリック名でオブジェク 
トファイルをリンクするよう指示することになります。 

ユーザ供給のフォントを登録する場合には， registerbgifont が返した値 
を， settextstyle に使用するフォント番号として渡さなければなりません。 


registerbgifont は，指定されたフォントが正しくない場合は，負のグラフ 
ィッ クスエラーコードを返します。そうでない場合は，登録したフォント 
のフォント番号を返します。 

registerbgifont は PC 9801 シリーズ（または IBM PC とその互換機）で 
のみ動作します （ IBMPC では，サポートするグラフィックスディスブレ 
イアダプタを備えていなければなりません）。 


graphresult , initgraph , instailuserdriver , registerbgidriver , 
settextstyle 

/* ゴシックフォントを*鋒*/ 

if (registerbgifont(gothic 一 font) !- GOTHIC FONT) exit(l); 


グラフイックス 関数 リファレンス 


591 


restorecrtmode 


機能 画面モードを， initgraph 実行前のモードに戻します。 

形式 # include く graphics.h 〉 

void far restorecrtmode (void) : 

プロトタイプ graphics.h 

解脱 restorecrtmode は， initgraph によつて検出された元の画面モードを回復 

します。 

restorecrtmode は， setgraphmode と組み合わせて，テキストモードとグ 
ラフィックモードの間を行き来するために使用することができます。 text - 
mode を同じ目的で使用することはできません。 textmode は，画面がテキ 
ストモードのときにのみ使用でき，他のテキストモードに切り換えるとき 
に使うことができます。 

注意： IBMPC では，テキスト画面とグラフィックス画面を同時に表示す 
ることができないためにこうした関数が用意されています。 PC -9801 では, 
间時表示が可能なので， restorecrtmode および setgraphmode を使わず 
に，グラフィックス出力とテキスト出力を混在させて，その両方を画面に 
表ホさせることができます。 restorecrtmode および setgraphmode は，ど 
ちらも画面全体をクリアして初期化するので， PC -9801 でこれらを使う場 
合には，テキストとグラフ ィッ クスを同時に表示することはできません。 

戻り偭 ありません。 

可搬性 restorecrtmode は PC -9801 シリーズ（または IBM PC とその互換機）で 

のみ動作します （IBM PC では，サポートするグラフィックスディスブレ 
イアダブタを備えていなければなりません）。 

間連項目 getgraphmode ， initgraph ， sets：raphmode 
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sector 


機能 

形式 


搰円の M 形を描いて，その中をフィルします。 

# include <graphics.h> 

void far sector (int ズ ， int 少 ， int stangle % int endang/e, 

int xradius, int yradius ) : 


ブロトタイプ graphics.h 


解脱 sector は，中心を（ズ，夕)，水平および垂直方向の半径をそれぞれズ⑺ゴル _ y ， 

yradius とし , P] 傻が stangle か b endangle までの楕円の铖形を描いて，そ 
の中をフィルします。闞形の輪郭はカレントカラーで描かれ， setfillstyle 
および 8 etfillpattern でセットされているハ。ターンとカラーでフィルし# 
す。 

sector に与える角度は • 反時計回りで， 3 時の位が 0.,12 時の位 3¢ が 90 。 
となります。 

惰闪の觸形をフィルしているときにエラーが起きた場合， graphresult It 
-6 (grNoScanMem) を返します。 

戻り 値 ありません。 


sector は PC-9801 シリーズ（または IBM PC とその互換機）でのみ動作し 
ます （ IBMPC では，サポートするグラフィックスディスプレイアダプタ 
を備えていなければなりません）。 


M 連項目 


arc ， circle ， ellipse ， getarccoords ， getaspectratio ， pieslice, 
setfillpattern ， setfillstyle, setgraphbufsize 


グラフイックス 閫数リ ファレンス 
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setactivepage 


機能 

形式 

プロトタイプ 

解脱 


戻り値 

可撤性 

関連項目 

例 
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グラフ ィッ クス出力を行なうアクティブページをセットします。 

# include <graphics.h> 

void far setactivepage(mt page ) : 


graphics.h 


setactivepage は， page をアクティブグラフィックスベージにセットしま 
す。これ以降，グラフィックス出力はグラフィックスページ page に対して 
行なわれます。 

使用しているシステムがグラフ ィッ クスページを何枚持っているかによっ 
て，アクティブグラフィックスページが闽面に見えている場合と見えてい 
ない場合があります。 

注意：この関数はデバイスを直接制御するもので，現在使用中のシステム 
にページが何ページ存在するかは得ることができません。 PC .9801 では，初 
期型の PC -9801 と PC -9801 U はグラフ ィッ クスページを1画面しか持っ 
ていません。他のタイプはグラフ ィッ クスページを2枚持っており，1枚目 
が0ページ，2枚目が1ページになります。 

ありません。 


setactivepage は PC -9801 シリーズ（または IBM PC とその互換機）での 
み動作します （IBM PC では，サポートするグラフィックスディスプレイ 
アダプタを備えていなければなりません）。 


seivisualpage 

cleardevice() ; 
8etvi8ualpage(0) ; 
8etactivepage(l); 
bar(50 f 50 f 150, 150); 
setvisualpage(l); 


I* 0 ページをビジュアルに */ 
/*1 ページを出力用に使う */ 
/* 1 ページにバーを描画 */ 
/* 1 ページをビジュアルに */ 
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setallpalette 

機能 すべてのバレットカラーを指定どおりに変更します。 

形式 # include く graphics . h 〉 

void far setallpalette (struct palettetype far * palette ) : 

プロトタイプ graphics.h 


setallpalette は， palette が指す palettetype 型構造体の内容にしたが っ 

て，カレントバレットを変更します。 

EGA 八 r GA のハ•レット中のカラーは， setallpalette によって部分的に（あ 
るいは全部を）変更することができます。 

setallpalette で用いられる定数 MAXCOLORS と palettetype 型構造体 

は， graphics . h の中で次のように定義されています。 

Idefine MAXCOLORS 15 

struct palettetype { 
unsigned char size; 
signed char colors[MAXCOLORS + 1]; 

)5 

j たどは，カレントグラフ イッ クスドライバと，カレントグラフィックスモー 
ドでの，バレット中のカラー数です。 

colors は ，パレット中の各項目に対応する実際のカラー番号を要素とする 
ぬぞバイトの配列です。 colors の要素が-1の場合は，その項目のパレットカ 
フーは変更されません。 setallpalette で使われる配列 colors の要素は， 
graphics . h の中で定義されている以下のシンボリック定数で表わすことが 
できます。 


PC -9801 / CGA EGA / VGA 

名前 値 名前 値 

BLACK 0 EGA BLACK 〇 


グラフイックス関数リファレンス 
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BLUE 

GREEN 

CYAN 

RED 

MAGENTA 

BROWN 

LIGHTGRAY 

DARKGRAY 

LIGHTBLUE 

LIGHTGREEN 

LIGHTCYAN 

LIGHTRED 




YELLOW 

WHITE 



EGA WHITE 


指定できるカラーはカレントグラフィックスドライバとグラフィックスモ 
ードに依存していることに注意してください。 

パレットを変更すると，変化は即座に画面に反映されます。バレットの力 
ラーが変化するたびに，画面上でそのカラーが表示されている部分はすべ 
て新しいカラーに変わります。 

注意： setallpalette は， IBM 8514 ドライバでは使用できません。 IBM 8514 
では setrgbpalette を使ってください。 

戻り値 ありません。 

setallpalette に正しくない入力を与えると， graphresult は-11を返し，力 

レン ト パレ ットは変更されません。 

可搬性 setallpalette は PC -9801 シリーズ（または IBM PC とその互換機 > でのみ 

動作します （ IBMPC では，サポートするグラフィックスディスプレイア 
ダブタを備えていなければなりません）。 

閣連項目 getpalette ， graphresult , setbkcolor , setcolor，setpalette 
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setaspectratio 

機能 デフォルトのアスぺクト比補正因子を変吏します。 

形式 # include く graphics.h 〉 

void far setaspectratio (int xasp % int yasp) \ 

プロトタイプ graphics.h 

解脱 setaspectratio は，グラフイックスシステムのデフォルトのアスペクト因 

子を変更するために使用します。アスペクト比は，グラフィックスシステ 
ムが円を真円として描くことができるようにするために使用されます。画 
面に出力した円が憤円になってしまうとすれば，モニタのピクセルの配 ; S 
が適切でないと考えることができます。このような場合，モニタを配 3 K し 
なおしてハード的に補正することができますが，ソフト的に 
setaspectratio を使ってアスべクト比を変史して補正することも可能です。 
现在のアスぺクト比は， getaspectratio の呼び出しによって得ることがで 
きます。 

戻り値 ありません。 

可搬 te setaspectratio は PC -9801 シリーズ（または IBM PC とその互換機）での 

み動作します （ IBMPC では，サポートするグラフィックスディスプレイ 
アダプタを備えていなければなりません）。 

閣連項目 circle，getaspectratio 


グラフイツクス 関数 リファレンス 
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setbkcolor 


概能 

/、。レットを用いてカレント ノくッ クグラウンドカラーを セッ 

卜します。 

形式 

# include < graphics . h > 



void far setbkcolor (int color ) : 


プロトタイプ 

graphics.h 



解脱 setbkcolor は，バックグラウンドを a > to / •で指定されたカラーにセットし 

ます。引数 co / or には， graphics . h で定義されている，次に示す名前あるい 
は番号を使うことができます。 


番号 

名前 

番号 

名前 

0 

BLACK 

8 

DARKGRAY 

1 

BLUE 

9 

LIGHTBLUE 

2 

GREEN 

10 

LIGHTGREEN 

3 

CYAN 

11 

LIGHTCYAN 

4 

RED 

12 

LIGHTRED 

5 

MAGENTA 

13 

LIGHTMAGENTA 

6 

BROWN 

14 

YELLOW 

7 

LIGHTGRAY 

15 

WHITE 


注意： PC .9801 の8色モード ( PC 98 C 8) でも，上の表のすべての名前あるい 
は番号を指定することはできますが，実際に表示される色は8色になりま 
す。8色モードの場合，上の表で同じ行に示されているカラーは同じ意味を 
持つことになります。 
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たとえば，バックグラウンドカラーを青にしたいときには， setbkcolor を 
次のように呼び出します。 

setbkcolor (BLUE 〉 I* または */ 8etbkcolor(l) 

CGA および EGA システムでは， setbkcolor は，バレット中の最初の項目 
を変更することによってバックグラウンドカラーを変更します。 


注窓： EGA または VGA システムで setpalette あるいは setallpalette に 

よってハ•レットカラーを変更する場合，定義済みのシンボリック定数は正 
しいカラーを示していないことがあります。これは， setbkcolor へのパラ 
メータが，特定のカラーではなく，カレントパレット中の項目番号を示し 
ているためです（渡されたパラメータが〇でなければ， バッ クグラウンドカ 
ラーは常に黒にセットされます)。 

戻り値 ありません。 

可撤性 setbkcolor は PC -9801 シリーズ（または IBM PC とその互換機）でのみ動 

作します （IBM PC では，サボートするグラフィックスディスプレイアダ 
ブタを備えていなければなりません）。 

W 連項目 getbkcolor , setallpalette , setcolor，setpalette 


グラフィックス 閧数 リファレンス 
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setcolor 


機能 パレットを用いてカレントドロウカラーをセットします0 

形式 # include <graphics.h> 

void iar setcoior(int color ) : 


プロトタイプ graphics.h 

解説 setcolor は，カレントドロウカラーをに設定します。⑺ / or の範囲は 

0から getmaxcolor までです。 

ドロウカラーとは，線などを描くときにビクセルにセットされる値のこと 
です。 PC -9801 シリーズおよび IBM PC の EGA では，次の表に示すドロウ 
カラーを使うことができます。 


番号 

名前 

番号 

名前 

0 

BLACK 

8 

DARKGRAY 

1 

BLUE 

9 

LIGHTBLUE 

2 

GREEN 

10 

LIGHTGREEN 

3 

CYAN 

11 

LIGHTCYAN 

4 

RED 

12 

LIGHTRED 

5 

MAGENTA 

13 

LIGHTMAGENTA 

6 

BROWN 

14 

YELLOW 

7 

LIGHTGRAY 

15 

WHITE 


ドロウカラーを選択するには，そのカラー番号あるいは対応するシンボリ 
ック名を setcolor に渡して呼び出します。たとえば PC -9801 でドロウカラ 
一に紫を選択したいとれば ， setcolor ( MAGENTA ), あるいは setcolor 

(5) とします。 
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注意： PC .9801 の8色モード （ PC 98 C 8) でも，上の表のすべての名前あるい 
は番号を指定することはできますが，実際に表示される色は8色になりま 
す。8色モードの場合，上の表で同じ行に示されているカラーは同じ意味を 
持つことになります。 

CGA システムでは以下のカラーが指定可能です。 


/ 《レットカラー番号（ビクセル値）に割り当てられている定数 


番号 

1 

2 

3 

0 

CGA 一 L 1 GHTGREEN 

CGA 一 L 1 GHTRED 

CGA 一 YELLOW 

1 

CGA_LIGHTCYAN 

CGA_LIGHTMAGENTA CGA WHITE 

2 

CGA 一 GREEN 

CGA 一 RED 

CGA BROWN 

3 

CGA _CYAN 

CGA _MAGENTA 

CGA _LIGHTGRAY 


たとえば CGAO モードでは，バレットには，バックグラウンドカラー，明 
るい緑，明るい赤，黄色の4色があります。このモードで贫色を選択したい 
とすれば ， setcolor (3)，あるいは setcolor ( CGAYELLOW ) を呼び出しま 
す。 

戻り値 ありません。 

可撤性 setcolor は PC -9801 シリーズ（または IBM PC とその互換機）でのみ動作 

します （IBM PC では，サポートするグラフィックスディスプレイアダブ 
夕を備えていなければなりません）。 

W 連項目 getcolor ， getmaxcolor ， setallpaiette , setbkcolor，setpalette 


グラフィックス関数リファレンス 
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setfillpattern 


機能 ユーザ定義のフィルパターンを定義します。 

形式 # include く graphics . h 〉 

void far setfillpattern ^char far 木 upattern % int color ) : 


プロトタィプ graphics.h 

解脱 setfillpattern は， setfilktyle と似ていますが，こちらはシステム定我のバ 

ターンではなく，ユーザ定義の8 X 8パターンを設定するために使用します。 
upattern は8バイ ト列を指すポインタです。各バイトはパターン中の8ピク 
セルに対応しています 0 バターン内で1に設定されている ビッ トに対応する 
ピクセルがブロツトされます。 

戻り価 ありません。 

可撤性 setfillpatern は PC -9801 シリーズ（または IBM PC とその互換機）でのみ 

動作します （ IBMPC では，サポートするグラフィックスディスプレイア 
ダブタを備えていなければなりません）。 

間連項目 getfillpattern , g ： etfillsettings , setfillstyle 
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setfillstyle 


櫬能 フィルパターンとフィルカラーをセットします。 

形式 # include < graphics . h > 

void far setfillstyle (int pattern ，int color ) : 

プロトタイプ graphics.h 

解脱 setfillstyle は，カレントフィルパターンとフィルカラーを設定します。ユ 

ーザ定義のフィルパターンを設定するには， setfillstyle に12 (USER 
の pattern を与えるのではなく, setfillpattern を呼び出してくださ 

い0 

graphics . h で定我されている/? //_ p が/ e /7? テーブルは，システム定義フィル 
ハ•ターンの名前とユーザ定義ハ•ターンの指示子を与えています0 


名前 



機能脱明 


EMPTYFILL 0バックグラウンドカラーでフイル（中空) 

SOLID—FILL 1ベタ塗り 

LINEFILL 2横線でフィル 

LTSLASHFILL 3 ///でフィル 

SLASH_FILL 4 ///でフィル，太線 

BKSLASH_FILL 5 \\\でフィル，太線 

LTBKSLASH FILL 6 \\\でフイル 

HATCH_FILL 7淡いハッチ（格子）でフィル 

XHATCHFILL 8濃いクロスハッチ（斜めの格子）でフィル 

INTERLEAVEFILL 9インターリーブ線でフィル 
WIDEDOTFILL 10すき間が広い点でフィル 

CLOSE _ DOT_FILL 11すき間が袂い点でフィル 
USER FILL 12ユーザ定義のフィルパターン 


戻り値 

可搬性 

M 連事項 
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EMPTY 一 FILL 以外のものは，カレントフイルカラーでフィルします。 
EMPTY 一 FILL は，カレント八ックグラウンドカラーを用います。 
setfillstyle に不適当な値が渡されると， graphresult は-11 ( grError ) を 
返し，フィルハ•ターンとフイルカラーは変更されず元のままになります。 

ありません。 

setfillstyle は PC -9801 シリーズ（または IBM PC とその互換機）でのみ動 
作します （ IBMPC では，サボートするグラフィックスディスプレイアダ 
ブタを備えていなければなりません）。 


bar ， bar 3 d , fillpoly , floodfill ， getfillsettin ^ s , graph result , 
pieslice , sector , setfillpattern 
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setgraphbufsize 


機能 内部グラフィックスバッファのサイズを変更します。 

形式 # include く graphics.h 〉 

unsigned far setgraphbufsize (unsigned oujsize) \ 

プロトタイプ graphics.h 

解脱 グラフィックスルーチンの中には （floodf ill のように）メモリハ•ッファを 

用いるものがあります。このメモリ バッファは initgraph が呼ばれたとき 
に確保され， closegraph が呼ばれたときに解放されます 。 graphgetmem 
によって確保されるハ •ッ ファサイズのデフォルトは4096バイトです。 

このバッファサイズを小さくしたいとき（メモリを節約する），あるいは大 
きくしたいとき（たとえば floodfill を呼び出してエラー値-7,すなわちフ 
ラッドフィルでメモリが不足した場合）にはこの関数を使うことになりま 
す 。 setgraphbufsize は， initg：raph に ， graphgetmem を呼ぶ際に内部 
バッファとしてどれだけのメモリを確保すべきかをつたえます。 

注意： setgraphbufsize は， initgraph より前に呼び出さなければなりま 
せん 0 initgraph が呼び出された後で行なわれたすべての setgraphbufs ¬ 
ize の呼ひ•出しは，次に closegraph が呼び出されるまでは意味をなしませ 
ん〇 

戻り値 setgraphbufsize は内部 バッファの 以前のサイズを返します。 

可搬性 setgraphbufsize は PC -9801 シリーズ（または IBM PC とその互換機）で 

のみ動作します （ IBMPC では，サポートするグラフィックスディスブレ 
イアダプタを備えていなければなりません）。 

閲士項日 closeg ： raph, g ： raphtreemem. g ： raphg ： etmem, initgraph 


グラフィックス閫数リファレンス 
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int cbsize; 

cbsize - setgraphbuf size(lOOO) 5 /* カレントサイズを得る */ 
setgraphbuf8ize(cbsize )； /* 元のサイズに霣す */ 
printf("The graphics buffer is currently 2d bytes.* f cbsize い 
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setgraphmode 


機能 システムをグラフィックモードにセットし，テキスト画面をクリアします。 

形式 # include く graphics . h 〉 

void far setgraphmode (mt mode ) : 

プロトタイプ graphics.h 

解脱 setgraphmode は， initgraph で設定されるデフォルトのモードとは 違っ 

たグラフィックスモードを選択します。 mode はカレン トデバイスドライ 
バに有効なモードでなければなりません。 setgraphmode は画面をクリア 
し，すべてのグラフィックス設定をデフォルトにセットします （ CP , パレ 
ット，” フー，ビュー ボートなど ）。 setgraphmode は restorecrtmode と 
ともに，テキストモードとグラフィックスモードの切り替えに使用します。 

注意： IBM PC では，テキスト画面とグラフィックス画面を同時に表示す 
ることができないためにこうした関数が用意されています。 PC 9801 では， 
间時表示が可能なので， restorecrtmode および setgraphmode を使わず 
に，グラフィックス出力とテキスト出力を混在させて，その両方を画面に 
表示させることができます。 restorecrtmode および setgraphmode は，ど 
ちらも画面全体をクリアして初期化するので， PC -9801 でこれらを使う場 
合には，テキストとグラフィックスを同時に表示することはできません。 

戻り值 カレント デバィ スドライ八に不適当なモードを setgraphmode に与えた 

場合 ， graph result は- lO ( grlnvalidMode ) の値を返します。 

可撤性 setgraphmode は PC -9801 シリーズ（または IBM PC とその互換機）での 

み動作します （IBM PC では，サポートするグラフィックスディスプレイ 
アダプタを備えていなければなりません）。 

運項目 ^ etgraphmode , getmoderange , graphresult , initgraph , restorecrt - 

mode 


グラフィックス 関数 リファレンス 
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setlinestyle 


機能 カレントライン幅とラインスタイルをセットします。 

形式 # include く graphics . h 〉 

void iar setlinestyle(int linestyle ，unsigned upattern % int thickness ) : 

プロトタイプ graphics.h 

解言 兄 setlinestyle は， line ， lineto ， rectangle，drawpoly などで描かれるすべ 

てのラインスタイルを設定します。 

linesettingstype 構造体は， graphics . h で次のように定義されています。 

struct Iine8etting8type { 
int line8tyle； 
unsigned upattern； 
int thickness; 

}； 

linestyle は， それ以降に描かれるラインのスタイルを指定します（たとえ 
ば，货線，点線，一点鎖線，破線)。 graphics . h で定義されている // style 
テーブルには，これらの谀算子の名前が与えられています。 


名前 値 檨能 


SOLID LINE 
DOTTED LINE 
CENTER LINE 
DASHED LINE 


0 実線 

1 点線 

2 —点銷線 

3 破線 


USERBIT LINE 


ユーザ定義のラインスタイル 



thicfcness は， それ以降に描かれる線の幅が，普通か太いかを指定するもの 
です。 
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名前 値 

機能 

NORMWIDTH 1 

1 ピクセル幅 

THICK 一 WIDTH 3 

3 ピクセル幅 


upattern ( i , //>；打/>*が USERBIT _ LINE (4) のときにのみ適用する 16 ビッ 

トバターンです。この場合，パターンワード内の1のビットに対応するライ 
ン内のピクセルカぐ，カレントドロウカラーで描かれます。たとえば，実線 
は OxFFFF の turner/! (すべてのピクセルの描画）に対応し，破線は 0x3 333 
または OxOFOF の upattern に 対応します。 setlinestyle の引数 linestyle が 
USERBIT_LINE ⑷でない場合も， "pattern は与えなければな i) ません 
(無视されますが)。 

注 M : linestyle パラメータは， 円弧，円周，憤円弧，檳円周には影®を与え 
ません （ fej 形と搰円の W 形の半径には彩製を与えます）。 thickness パラメー 
夕はこれらに影®します。 

戻り値 setlinestyle に不適当な値が渡された垛合， graphresult は-11を返し，力 

レントラインスタイルは変化しません。 

可撤性 setlinestyle は PC -9801 シリーズ（または IBM PC とその互換機）でのみ 

動作します （ IBMPC では，サポートするグラフィックスディスプレイア 
ダブタを備えていなければなりません）。 

関連項白 bar 3 d , getlinesetting ^, graphresult ， line ， linerel ， lineto，rectangle 
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setnewdriver (PC-9801 のみ ) 


機能 デフォルト以外のグラフイックスドライバを登録します。 

形式 # include く graphics.h〉 

int far setnewdriver (” PC98” ， detect98) : 

プロトタイプ graphics.h 

解脱 setnewdriver は，バージ ョ ン 1.5 のコードとの互換性のためにのみ用意さ 

れているもので，内部では単にそのままの引数で installuserdriver を呼び 
出すだけです。 

バージ ヨ ン 2.0 では， PC-9801 のドライバもあらかじめ BGI の内部テープ 
ルに登録されているので, setnewdriver を呼び出す必要はなくなっていま 
す。 

詳しくは， initgraph および installuserdriver を参照してください。 

戻り値 installuserdriver と同じです。 

可搬性 FC-9801 シリーズでのみ動作します。 

閱連項目 installuserdriver 
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setpalette 


概能 パレットカラーの 1 つを変更します。 

形式 # include く graphics.h 〉 

void far setpalette (int colornum, int color) : 

プロトタイプ graphics.h 

解說 setpalette は，パレットの中の colornum 番目の項目を， color に変更しま 

す。たとえば setpalette (0,5) は，カレントパレットの最初のカラー（バッ 
クグラウンドカラー）を，実際のカラー番号 5 のカラーに変更します。 

がカレントハ •レッ トに含まれる項目の数とすると， colornum は〇から [size. 
1) との間の値をとることができます。 

PC-9801 および IBM PC の EGA/VGA のパレット中のカラーは， 
setpalette によつて， 1 項目ごとにセットすることができます。 CGA では， 
setpalette で変更できるのはハ • レット中の缎初の項目 = バッ 
クグラウンドカラー）だけです。 

setpalette に渡す color パラメータは， graphics.h の中で定義されている 
以下のシンボリック定数で表わすことができます。 


PC-9801 / CGA 
名前 


EGA / VGA 

値 名前 


BLACK 

BLUE 

GREEN 

CYAN 

RED 

MAGENTA 

BROWN 

LIGHTGRAY 



値 




グラフィ ッ クス 関数 リファレンス 



戻り値 

可撤性 

関連項目 
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DARKGRAY 

8 

EGADARKGRAY 

56 

LIGHTBLUE 

9 

EGA LIGHTBLUE 

57 

LIGHTGREEN 

10 

EGA 一 LIGHTGREEN 

58 

LIGHTCYAN 

11 

EGA_LIGHTCYAN 

59 

LIGHTRED 

12 

EGA 一 LIGHTRED 

60 

LIGHTMAGENTA 

13 

EGA_LIGHTMAGENTA 

61 

YELLOW 

14 

EGA 一 YELLOW 

62 

WHITE 

15 

EGA WHITE 

63 


指定できるカラーはカレントグラフィックスドライバとグラフィックスモ 
ードに依存していることに注意してください。 

パレットを変更すると，変化は即座に画面に反映されます。パレットカラ 
一が変化するたびに，画面上のそのカラーが表示されている部分はすべて 
新しいカラーに変わります。 

注意： IBM8514 ドライ八では setpalette は使用できません。 IBM8514 で 
は， setr 劣 bpalette を使用してください 0 

正しくない人力を setpalette に与えると ， graph result は -11 (grError) 
を返し，カレントバレットは変更されません 0 

ありません。 

setpalette は PC-9801 シリーズ（または IBM PC とその互換機）でのみ動 
作します （ IBMPC では，サポートするグラフィックスディスブレイアダ 
ブタを備えていなければなりません）。 


getpalette ， graphresult ， setallpalette ， setbkcolor ， setcolor, 
setrgbpalette 
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setrgbpalette (PC-9801) 


機能 ハードウヱア パレ ットの実際の色を定義します。 

形式 # include <graphics.h> 

void far setrgbpalette(int colornum % int red, int green, int blue ) : 

プロトタイプ graphics.h 

解脱 setrgbpalette は， colornum で指定されたバレットの実際の色を red 、 

green, blue で指定した値に変更します。 

この関数により PC-9801 シリーズの 16 色モードでは， 4096 色中から任意の 
16 色を選んで使うことができます。 

red, green, blue のの有効範囲はカレントグラフィックスモードに依存 
しています。 PC-9801 ではこれらの値は以下のようになります。 


- ド (PC98C8) 



ド (PC98C16) 







戻り値 ありません。 

可搬性 setrgbpalette は PC-9801 シリーズでのみ動作します。 

関連項目 setpalette 
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setrgbpalette (IBM PC) 


機能 

形式 

プロトタイプ 

解脱 


戻り値 
可搬性 

関連項目 

614 


IBM 8514 のカラーを定義します。 

# include < graphics . h > 

void far setrgDpalette(mt colornum , int red ，int green , int blue ) : 
graphics.h 

setrgbpalette は， IBM 8514 およひ • VGA ドライバにおいて使用すること 
ができます。 

colornum はロードするバレット項目を定我し， re ゴ，ぎびび，および 6/ we は 
バレット項目の色要素を定義します。 

IBM 8514 ディスブレイ（および 256 K カラー モー ドでの VGA ) では， color ¬ 
num の範囲は〇〜255になります。 VGA の他のモードでは， colornum の範 
囲は〇〜15です。 red 、 green , および Wwe は下位バイトのみが使用され，そ 
の下位 ハ •イトの上位6 ビッ トだけが ハ•レッ トにロードされます。 

注意：他の IBM グラフィックスアダプタとの互換性のために， BGI ドラ 
イバは， IBM 8514 の先頭から16個のバレット項目を EGA / VGA のデフ ォ 
ルト々ラーと同じものに定義しています。これらの値はそのまま使用する 
ことができ，また， setrgbpalette で変更することもできます。 

ありません。 

setrgbpalette は，サボートするグラフィックスディスブレイアダブタを 
備えた IBM PC およびその互換機でのみ動作します。 


setpalette 
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settextjustify 

機能 テキスト出力の位置合わせを設定します。 

形式 # include く graphics . h 〉 

void far settextjustiiy(int horiz 、 int vert ) : 

プロトタイプ graphics.h 

解脱 settextjustify の呼び出し後に出力されるテキストは， CP に対して縦方向 

および横方向に指定された位合わせ（テキストのどこを CP に合せて出 
力するか）が行なわれます。デフォルトの位 ffi 合わせの設定は LEFT 
TEXT (水平方向)， TOP_TEXT (垂直方向）です。 
graphics . h の中の列乎切 text_Jus 〖は ， settextjustify に渡される horiz と 
vert の設定に使う名前を定我しています。 


horiz が LEFT—TEXT に等しく， direction が HORIZ_DIR の場合には， 
CP の ズ 座標は， outtext ( 灯 r/wg) を呼び出した後では， text width ( 价 / 叹） だ 
け増加することになります。これ以外の位置合わせの設定の場合には CP 
は変化しません。 

settextjustify は， outtext および outtextxy によって害かれるテキスト 
に効果を持ちます。テキストモードやストリーム関数に対しては意味を持 
ちません。 


方向 

水平 

水平および垂直 

水平 

垂直 

垂直 


名前 

LEFT_TEXT 
CENTER 一 TEXT 
RIGHT TEXT 
BOTTOM 一 TEXT 
TOP TEXT 
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settextjustify に無効な入力を i 度すと， graphresult は-11 ( grError ) を返 

し，カレントテキストの位 S 合わせの指定は変化しません。 


戻り値 ありません。 

可搬性 settextjustify は PC -9801 シリーズ（または IBM PC とその互換機）での 

み動作します （ IBMPC では，サポートするグラフィックスディスプレイ 
アダプタを備えていなければなりません）。 

関連項目 gettextsettings , graphresult , outtext，settextstyle 
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settextstyle 


機能 グラフイックス出力のカレントテキスト厲性をセットします。 

形式 # include く graphics . h 〉 

void far settextstyle(int font 、int direction ,int charsize )； 

ブロトタイプ graphics.h 

解脱 settextstyle は，テキストフォント，テキストの表示される向き，文字のサ 

イズをセットします 0 settextstyle の呼び出しは， outtext および outtex - 
txy によって出力されるテキストすべてに杉®を与えます。 
settextstyle に渡されるパラメータ font , direction , charsize は 次に示すよ 
うな意味を持ちます。 

介が：1組の 8X16 ビットマップフォント （IBM PC では 8X8) と，いくつ 
かのスト ローク フォントが使用できます 0 8X16 (または 8X8) ビットマッ 
ブフォントがデフォルトです。 graphics . h の中で定我されている列挙型 
ybmmjmer により•こうした神•々のフォントの設定に用いる名前が与えら 
れています（次に示す表を参照してください）。 


名前 

値 

説明 



DEFAULT 一 FONT 

0 

8 X 16 (8 X 8) 

ビットマッブフオント 

TRIPLEXFONT 

1 

ス \ 

、 〇 — 

ク • 

トリブレックスフォント 

SMALLFONT 

2 

ス \ 

‘ 口一 

ク • 

スモールフォント 

SANSSERIF FONT 

3 

ス \ 

‘ D — 

ク • 

サンスセリフフォント 

GOTHIC 一 FONT 

4 

フ、\ 

‘ 〇 — 

ク • 

ゴシックフォント 
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デフォルトのビットマ ッブ フォントはそのまま使用できます。ストローク 
フォントは* . CHR というディスクファイルに蓄えられており， 一度に ひ 
とつしかメモリに置けません。そのため，ストロークフォント（一番最後 
に選んだストロークフォントと別の M 類の物）を選ぶときには，対応する 
*. CHR ファイルをディスクから読み込まなくてはいけません。いくつか 
のストロークフォントを使用するとき，この読み込みを避けるためには， 
プログラムにフォントファイルをリンクすることになります。 BGIOBJ ユ 
ーティリティでこれをオブジェクトファイルに変換し ， registerbgifont 
でそれを登録するという手順でリンクすることができます （ BGIOBJ につ 
いてはユーザーズガイド付録 C で説明しています）。 

漢字が使用できるのはデフォルトのビットマッブフォントだけです。 

め>代7/0/1 :サポートされているフォントの向きは，水平テキスト（左から 
右）と垂直テキスト（反時計回りに90度回転した向き）です。デフォルト 
の方向は HORIZ DIR です。 


名前 


H 0 RIZ 

VERT 




戻り値 

可撤性 

関連項目 


charsize :文字の大きさは charsize 因子を使って拡大することができます。 
c /^打加が〇でない場合は， ビッ ト マップ およびストローク文字が影鄹を受 
けます。 charsize が Q の場合は， ストローク文字だけが影®を受けます。 


■ charsize が 1 の場合， outtext と outtextxy は画面上の 8X16 ピクセル 
の長方形の領域に， 8 X 16 ビットマッブ フォン トの文字を表示します。 

■ charsize が 2 の場合，これらの出力関数は 16X32 ピクセルの長方形の領 
域に， 8X16 ビットマップ フォン トの文字を表示します（以下同様に標 
準サイズの10倍 charsize = 10 まで可能です）。 

■ charsize が 0 の場合，出力関数 outtext と outtextxy は，デフォルトの 
文字拉大因子 4 (4 倍)，あるいは setusercharsize によって与えられる 
ユーザ定義の文字サイズのどちらかを使用して，ストロークフォント 
テキストを拡大します0 


テキストの実際の大きさを調べるには，必らず textheight と textwidth 

を使用してください。 

ありません。 

settextstyle は PC -9801 シリーズ（または IBM PC とその互換機）でのみ 
動作します （IBM PC では，サポートするグラフィックスディスプレイア 
ダブタを備えていなければなりません）。 


^ etiextsettings , graphresult , installuseriont , settextjustify , 
setusercharsize , textheight , textwidth 
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setusercharsize 


機能 ストロークフォント文字の幅と高さを変更します。 

形式 # include < graphics . h > 

void far setusercharsize (mt multx , int divx % int mutlv % int divy ) : 

プロトタイプ graphics.h 

解脱 setusercharsize は，グラフィックス関数で使用されるストローク フォン 

卜によるテキストのサイ X を制御します。 setusercharsize によってセッ 
卜される値は， settextstyle の charsize パラ メータが 0 のときにのみ有効で 
す 0 したがって， setusercharsize の前に settextstyle を呼び出して 
加を0にセットしておく必要があります 0 

setusercharsize を使って，幅と商さを決定するスケール因こ f •を指定しま 
す。デフォルト幅は multx/divx 倍され，デフォルトの商さは multy/divy 倍 
されます。たとえば，テキストの幅を2倍に，高さを50%商くするには次の 
ようにします。 

multx — 2 ； divx =1: 
multy = 3 : divy = 2 : 

戻り値 ありません。 

可搬性 setusercharsize は PC -9801 シリーズ（または IBM PC とその互換機）で 

のみ動作します （IBM PC では，サポートするグラフィックスディスプレ 
イアダプタを備えていなければなりません）。 

閣連項目 gettextsettings , graphresult，settextstyle 
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例 


# include <graphics.h> 
#inckude <conio.h> 


main() 

{ 

int graphdriver - DETECT f graphmode; /* 自動核出を疑求 */ 
char *title - ■TEXT in a BOX"; 

initgraph( Sgraphdriver t &graphmode 9 /* 初期化 */ 

settextjustify(CENTER_TEXT t CENTER_TEXT); 

8etusercharsize(l•1 9 1 9 1); 

8ettext8tyle(TRIPLEX_P0NT f HORIZ_DIR t USER_CHAR_SIZE); 

8etu8erchar8ize(200 f textwidth(title) f 100 • textheight(title ))； 

rectangle(O f 0 f 200 f 100); 

outtextxy(100 f 50• title)5 

getche ()； 

clo8egraph(); 
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setviewport 


機能 グラフイツクス出力用のカレントビューボートを設定します。 

形式 # include く graphics . h 〉 

void setviewport (int left , int top , int right , int bottom , int dip ) \ 


ブロトタイプ graphics.h 

解脱 setviewport は，グラフ ィッ クス出力用の新しいビューポートを作ります。 

ビューポートの四隅は，絶対画面座標の（/”，卿）と ( right , bottom ) によっ 
て与えられます。現在位3¢ ( CP ) はビューポートの （0.0) へ移されます。 
引数 c / ip は ，描阐がカレントビューボートの境界でクリッピングされる 
(端が切り取られる）かどうかを決めます。ブログラムの中で setviewport 
を呼び出したときに c / かが0でない場合は，すべての描画はカレントビュ 
ーボートによってクリッビングされます。 

無効な入力が setviewport に渡されると， graphresult は-11を返し，カレ 
ントビューポートの設定は変化しません。 

戻り値 ありません。 

可搬性 setviewport は PC -9801 シリーズ（または IBM PC とその互換機）でのみ 

動作します （ IBMPC では，サポートするグラフィックスディスプレイア 
ダブタを備えていなければなりません）。 

関漣 項目 clearviewport , getviewsettings , graphresult 
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setvisualpage 


機能 

形式 

プロトタイプ 

解脱 

戻り値 
可搬性 

間連項目 

例 


ビジュアルグラフイツクスページ番号をセツトします。 

# include < graphics . h > 

void far setvisualpage(int page ) : 

graphics.h 

setvisualpage は， page をビジュアルグラフィックスページにセットしま 



ありません。 


setvisualpage は PC -9801 シリーズ（または IBM PC とその互換機）での 
み動作します （IBM PC では，サポートするグラフィックスディスブレイ 
アダプタを備えていなければなりません）。 


graphresult setacuvepage 


setactivepage を参照してください 0 
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setwritemode 


機能 グラフイックスモードにおける描線の辫き込みモードを設定します。 

構文 # include く graphics . h 〉 

void rar setwritemode(int mode ) : 


ブロトタイプ graphics.h 

脱明 次の2つの定数が定我されています。 

COPY_PUT _ 0 /* MOV */ 

XOR_PUT -1 /* XOR */ 

各定数は，線の各ピクセルと_面の対応するピクセルとの問の2進演炸に纣 
応しています。すなわち ， COPY PUT はアセンブリ言語の MOV 命令を 
使って，画面上にあるものすべてに対して線を上#きします 。 XORPUT 
は， XOR 命令を使って，_面上にあるものと線に対して排他的 OR 操作を 
行ないます。連絞して2回 XOR 命令を行うと，線は消えることになり，画 
面は元通りになります。 

> 主意 . 8 etwritemode は现在のところ， line , linerel ， lineto , rectangle , 
drawpoly に対してだけ有効です。 

戻り値 ありません。 

可搬性 setwritemode は PC -9801 シリーズ（または IBM PC とその互換機）での 

み動作します （ IBMPC では，サポートするグラフィックスディスプレイ 
アダプタを備えていなければなリません）。 

関連項目 drawpoly , line , linerel ， lineto , putimage 
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textheight 

機能 文字列の高さをピクセル単位で返します。 

形式 # include < graphics . h > 

int textheight (char far 氺 textstring ) : 

プロトタイプ graphics.h 

解脱 グラフィックス関数 textheight は，カレントフォントサイズと拡大因子 

を用いて文字列 textstring の高さをピクセル単位で求めます。 

この関数は，行間のスペースを調祭したり，ビューボートの高さを計 W •し 
たり，グラフ上やボックスの中にフィットするタイトルの大きさを求めた 
い場合に便利です。 

たとえば PC -9801 では， 8 X 16 のビットマップフォントで，拡大因子が 
1 ( settextstyle でセットされる）のとき，文字列” Turbo C ” は16ピクセル 
の商さになります 。 IBM PC では， 8 X 8 ビットマップフォントで大因子 
が1であれば ， ’’Turbo C ” の商さは8ビクセルになります。 
textheight を使うと，いちいち手計恋をしなくても，文字列の商さを求め 
ることができます。この関数を使えば，違ったフォントが選ばれた場合で 
も，ソースコードを変史する必要がないようにすることもできます。 

戻り値 textheight は，テキストの商さをピクセル単位で返します。 

可搬性 textheight は PC -9801 シリーズ（または IBM PC とその互換機）でのみ動 

作します （ IBMPC では，サポートするグラフィックスディスプレイアダ 
プタを備えていなければなりません）。 

W 連項目 gettextsettings , outtext ， outtextxy , settextstyle , textwidth 
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textwidth 


機能 文字列の幅をピクセル単位で返します。 

形式 # include く graphics . h 〉 

int iar textwidth ichar far * textstring ) : 

プロトタイプ graphics.h 

解脱 textwidth は，文字列の長さ，カレントフォントサイズ，拡大因子を用い 

て，文字列 textstring の幅を求めます 0 

この関数は，ビューボートの幅を計算したり，グラフ上やボックスの中に 
フィットするタイトルの大きさを求めたい場合に便利です。 
textwidth を使うと，いちいち手計麻をしなくても，文字列の幅を求めるこ 
とができます。この関数を使えば，違ったフォントが選ばれた場合でも， 
ソースコードを変史する必要がないようにすることもできます。 

戻り値 textwidth は，テキストの商さをビクセル単位で返します。 

可搬性 textwidtht は PC -9801 シリーズ（または IBM PC とその互換機）でのみ動 

作します （ IBMPC では，サボートするグラフィックスディスブレイアダ 
ブタを備えていなければなりません）。 

M 連項目 gettextsettings , outtext , outtextxy , settextstyle , textheight 
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PC -9801 の ROM - BIOS インターフェース 


PC - 9801用 ROM - BIOS インターフェースルーチンは，マシンの ROM チップに組み込ま 
れているハードウヱア基本制御ルーチンを駆動するためのインターフヱースルーチンです。 
これらの関数を使用すれば，マシンの機能を最大限に引き出すことができます。ただし， 

他機棟との互換性はまったくないので，可搬性のあるブログラムを作成しようとするので 
あれば，このインターフェースは使用すべきではありません。ここで説明するすべての関 
数は， PC -9801 シリーズでのみ使用することができます。 

ROMBIOS インターフェースを使うと，次のようなことが行なえます。 


■システム情報を得る （ bios 98 equip など） 

■キーボードインターフエース ( bio 898 key ) 

■ディスク装: K の操作 （ bio 898 disk など） 

■プリンタの制御 ( bios 98 print ) 

■ RS 232 C の制御 （ bios 98 com ， bios 98 coin」nit など） 

■マウスの制御 （ bios 98 mouse など） 

■インターハ•ルタイマの制御 ( bios 98 timer など） 

■日付時刻の読み出しと設定 ( bios 98 time ) 

■ ROM のフォントパターンの読み出しとユーザ定義文字の設定 （ getfont など） 

なお，インターフェースの詳細な仕様については，各機種の 「ユーザーズマニュアル j 
およひ•アスキー出版局の 「 PC - 9800 シリーズテクニカルデータブック 」などを参照して 
ください。 

パケット構造体 


各インターフェースルーチンでは， BIOS とのデータのやりとりを，携造体を通して行な 
います（構造体を使用しない関数もありますが)。この節では，こうした構造体のことをパ 
ケットと 総称しています。各ルーチンを使用する際には，パケット（構造体）の所定の位 
S (メンバ）に必要なハ•ラメータを入れ，そのハ•ケットを引数として関数を呼び出します。 

パケット構造体の最初の2つのメンバは，すべての BIOS 関数において共通で，1番目が 
機能コード（メンバ名 cmmd )， 2番目がステータス （ stus ) となっています。 cmmd には 
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ROM ルーチンに与える機能コードを指定します 3 stus は， ROM ルーチンを呼び出した後 
の状態（ステータス）で， BIOS の返した値が格納されます （ stus を使用しない関数もあり 
ます)。 

パケット構造体の3番目以降のメンバは，各関数によって異なり，対応する ROM ルーチ 
ンに応じたパラメータを指定したり， ROM ルーチンが返した値を格納したりします。 

パケットの解説では，次のような形式の表を使って説明しています（ただし， bios 98 disk 
および bios 98 harddisk は，これとはやや異なります。これらについては該当のページを見 
てください）。 


PACKETNAME 

1 

2 

3 

4 

• 

cmmd 

AH 

R 

R 

R 

R 

• • 

stus 

AH 

W 

W 

W 

W 

• • 

info 1 

CX 

W 

X 

X 

X 

• 參 

info _2 

ALCH 

X 

R 

W 

x 

• • 

info _3 

CL 

X 

Rx 

Rx 

X 

• • 

info 4 

ALCH 

X 

RW 

RW 

R 

參 • 

•參參 

• • 

• • 

• 參 

• • 

• • 

• • 


表の一番上の行は，搆造体の型名と使用できる機能コード （ cmmd に指定する値）で 
す。 機能コードは10進数で表わしています。 

2行目以下は左から，メンバ名，（その関数あるいは BIOS が使用する場合には）レジス 
夕名，およひ•そのメンバがどのように使用されるかを表わす記号です。ここで使われる記 
号は次のような意味を持っています。 


R 

ブログラムから BIOS に渡す 


W 

BIOS からブログラムに返す 


RW 

ブログラムから BIOS に渡し， 

BIOS が返す 

Rx 

ブログラムから BIOS に渡す， 

BIOS は上位8ビットのみを使用する 

X 

使用しない（以前の値は保証しない） 


当然のことながら， cmmd はすべて R になります。また stus は（使用される場合は）す 
ベて W になります。それ以下は関数によって異なっています。 
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bios98com 


機能 RS 232 C - BIOS を操作します。 

形式 # include < bios 98. h > 

unsigned bios 98 com ( COM_INFO * cmf ) : 

プロトタイプ bios 98 .h 


解脱 bios 98 com は，受信データサイズの取得，データの送信，データの受信， 

コントローラへのコマンド出力，コントローラの状態の取得を行ないます。 
搆造体 COM INFO は， bios 98. h の中で次のように定義されています。 


typedef struct { 
unsigned char 
unsigned char 
unsigned int 
unsigned char 
unsigned char 
unsigned char 
unsigned char 
} COM INFO; 


cnmd; 

8 tU 8； 

data_8iz ； 
data; 
data_inf 5 
ctrl_inf ； 
port_inf ； 


/* 機®コード */ 

/* 寅行後の状態 叫 

/* 受信データサイズ */ 

/* 送*信ヂータ *1 

/* 受信！•データの状戆 */ 

/* コント ロー ^の状！！ */ 

/* システムポートの状態 */ 


割り込みベクタテーブル ( OOOOOh 〜 003 FFh ) 内のタイマ割り込みと， RS - 
232 CBIOS で使用する割り込みべクタは，常に ROM 内の BIOS ルーチン 
を指しているとは限らないため， bios 98 coin では，これらを利用可能な状 
態にしてからブログラムを実行しています。通常は，ユーザブログラムが 
終了した時点で，自動的に割り込みベクタを復帰させていますが，ユーザ 
ブログラムを常駐終了させたい場合には，下に示す変数をブログラム内で 
外部定義してください。 


int bs com -1; 


bs _ com を0以外にすると，タイマ割り込み （INT OCh ) と RS -232 C BIOS 
(INT 19 h ) の割り込みべクタを，元の状態に戻さないようになります。 
MS - DOS がサポートする RS -232 C インターフェースと混在して使用しな 
いでください。また， MS - DOS の RS -232 C デバイスドライバは必要としま 
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せん。 


戻り値 各コマンドを実行した結果は16ビット中の下位8ビットに設定され返され 

ます。また，パケット内のメンバ stus にも格納されます。 


■パケッ ト内の データの 授受 


COM INFO 

2 

3 

4 

5 

6 

cmmd 

AH 

R 

R 

R 

R 

R 

stus 

AH 

W 

W 

W 

W 

W 

data siz 

CX 

W 

x 

X 

X 

X 

data 

ALCH 

X 

R 

W 

X 

X 

data inf 

CL 

X 

X 

W 

X 

X 

ctrlinf 

ALCH 

X 

X 

X 

R 

W 

port inf 

CL 

X 

X 

X 

X 

W 


M 連項目 bios 98 com ch 2, bios 98 com ch 3, 

bios 98 com init , bios 98 com init ch 2, bios 98 com init ch 3 
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例 


/include < 8 tdio.h> 
/include <bios98.h> 


#define ON 1 
/define OFF 0 


void com init(unsigned char *buf) 



COM_INIT cint; 
cint.crand _ 1 ; 
cint.transfer 
cint.mode_inf 
cint •cmrod 一 inf 
cint.recv buf 
cint.recv_siz 
cint. time_8nd 
cint•time_rcv 
bio898com. 
if (cint.stus 


0x06 
0x5E 
0x37 
buf 5 
256; 
0 x 10 ; 
OxOF; 
cint); 
0 ) 


printf(•init_8tus-Z02X•¥n_ 


/* X パラメータつき 


/* RS-232C の初期化 
9 cint•stus) : 




unsigned com 一 recvsize(> 

{ ~ 

COM_INFO cinf 5 
cinf.cond _ 2; 

bio898com(&cinf); /* 受信データサイズの取得 */ 

if (cinf.8tus l_ 0) 

printf(•recv8ize_8tu8-Z02X-¥n* f cinf•stus )； 
return cinf.data siz ； 


void com_send(unsigned ch) 

{ 一 

COM_INFO cinf; 
cinf.cnrod _ 3 ； 
cinf«data ■ ch; 

bios98com( &cinf ); /* データ进信 */ 

if (cinf.stus !- 0 ) 

printf(•send_8tu8-I02X.¥n* f cinf.stus); 


unsigned com 一 recv(void) 

{ 一 
COMJCNFO cinf; 
cinf.cmmd _ 4; 

bios98com(icinf )5 /* データ受信 

if(cinf.stU8 !■ 0) 

printf(•recv_8tus-202X.¥n* f cinf.stus); 
return cinf.data; 
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com_init(buf )； 
while (1){ 

gets(88tr)5 卜 

if (88tr[0] ― 0 ) { 

printfr 受信を M 始します。 ¥n 
while ((rch - com_recv()) 
printf(*Zc* f rch )5 /* 

printf C¥n*)5 

> 

else { 

printf (• 送信を M 始します 0 ¥n 
n _ strlen(88tr) + 1 ; 
for <i _ 0 ; i < n; i++) { 
8ch - 88tr[i ]； 
do { 

while (com_recv8ize( 
rch _ com_recv(>; 
switch (rch) { 
case 0x13i se 


0 x 11 


default 


if (send _■ ON) 

> 

while (send __ OPP) 
)m 8end(8ch); 




632 



bios98com_ch 2 

機能 

RS -232 C の2回線目用インターフェースです。 

形式 

# include < bios 98. h > 

unsigned bios 98 com _ ch 2 (COM INIT * cmi ) : 

プロトタイプ 

bios 98 .h 

解脱 

拡張 RS -232 C の 2 回線目用のインターフェースです。 

詳細については bios 98 com を参照してください。 

bios98com_ch3 

機能 

RS -232 C の3回線目用インターフェースです。 

形式 

# include < bios 98. h > 

unsigned bios 98 com _ ch 3( COM_INIT * cmi ) : 

プロトタイプ 

bios 98 .h 

解脱 

拡張 RS -232 C の 3 回線目用のインターフェースです。 

詳細については bios 98 com を参照してください。 
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bios98com」nit 


機能 

RS -232 C を初期化します。 


形式 

# include < bios 98. h > 



unsigned bios 98 com init (COM INIT * cn 

»/): 


プロトタイプ bios 98 .h 


解脱 


Wos 98 comJnit は， RS -232 C の初期化，制御を伴う初期化を行ないます。 
構造体 COM INIT は， bios 98. h の中で次のように定義されています。 


typeder struct { 


unsigned 

char 

cnnxl; 


unsigned 

char 

8 tU8 ； 


unsigned 

char 

transfer 

unsigned 

char 

mode- 

•inf 

unsigned 

char 

cn«nd_ 

*recv_ 

inf 

unsigned 

char 

buf 

unsigned 

int 

recv_ 

8 iz 

unsigned 

char 

time— 

snd 

unsigned 

char 

time 

rev 


)COM INIT; 


/* 機能コード */ 

/* 実行後の状態 */ 

/* トランスフアレート */ 

/* モー ド播定 */ 

/* コマンド指定 */ 

/* 受信バッファ */ 

/* 受信バッファサイズ */ 


/* 送信 _ のタイムアウト轉問 */ 
/* 受信轉のタイムアウト */ 


割り込みべクタテーブル ( OOOOOh 〜 003 FFh ) 内のタイマ割り込みと， RS - 
232 CBIOS で使用する割り込みべクタは，常に ROM 内の BIOS ルーチン 
を指しているとは限らないため， bio 898 com 」 nit では，これらを利用可能 
な状態にしてからブログラムを実行しています。通常は， ユーザ ブログラ 
ムが終了した時点で，自動的に割り込みベクタを復帰させていますが，ユ 
ー ザブログラムを常駐終了させたい場合には，下に示す変数をブログラム 
内で外部定義してください。 


int bs com -1; 


bscom を0以外にすると，タイマ割り込み （INT OCh ) と RS -232 C-BIOS 
(INT 19 h ) の割り込みべクタを，元の状態に戻さないようになります。 
MS - DOS がサポートする RS -232 C インターフェースと混在して使用しな 
いでください。また， MSDOS の RS -232 C デバイスドライバは必要としま 
せん。抗張 RS -232 C ( bios 98 com init ch 2， bios 98 com init ch 3) で使用 
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するとき，バケツト内のトランスファレート transfer は使用しません（増 
設ボード上のディッブスイッチで指定します)。 


戻り値 


可搬性 

関連項目 

例 


各コマンドを実行した結果は 16 ビット中の下位 8 ビットに設定され返され 
ます 0 また，バケット内のメンバ stus にも格納されます。 

■バケツト内のデータの授受 


COM INIT 

0 

1 

cmmd 

AH 

R 

R 

stus 

AH 

W 

W 

transfer 

AL 

R 

R 

mode ini 

CH 

R 

R 

cmmd inf 

CL 

R 

R 

recv_buf 

ESDI 

R 

R 

recv siz 

DX 

R 

R 

time_snd 

BH 

R 

R 

time rev 

BL 

R 

R 


PC-9801 シリーズでのみ動作します。 

bios98com f bios98com ch2, bios98com ch3, 
bios98com—init—ch2, bios98com—init ch3 

bios98com を参照してください。 
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bios98com 」 nit_ch 2 


機能 2 回線目の RS-232C を初期化します。 

形式 # include <bios98.h> 

unsigned bios98com_init_ch2(COM_INIT * cmi) \ 

プロトタイプ bios98.h 

解脱 拡張 RS-232C の 2 回線目用を初期化を行ないます。 

詳細については， bios 98 com init を参照してください。 

戻り値 拡張 RS-232C 枘設ボードを実装しないでこの関数を呼び出すと， 0 以外を 

返します。 


bios98com 」 nit-ch3 

機能 3 回線目の RS-232C を初期化します。 

形式 # include <bios98.h> 

unsigned bios98comjnit_ch3(COM_INIT * cmi) \ 

プロトタイプ bios98.h 

解脱 拡張 RS-232C の 3 回線目用のインターフェースです。 

詳細については bios 98 com init を参照してください。 

戻り値 拡張 RS-232C 増設ボードを実装しないでこの関数を呼び出すと， 0 以外を 

返します。 
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bios98disk 


機能 ディスク BIOS を操作します。 

形式 # include く bios 98. h > 

unsigned bios 98 disk ( DISK_INFO * dsk ) \ 

ブロトタイプ bios 98 .h 


解脱 bio 8 98 disk は，フロッピィディスクを直接制御するためのルーチンです。 

パヶット引数ゴ从内のメンバ cmmd により各禅のコマンドを実行します。 

構造体 DISK INFO は， bios 98• h の中で次のように定義されています。 

typedef struct { 

unsigned char cmmd; 
unsigned char stus; 
unsigned char device typ; 
unsigned int data_siz; 
unsigned char sector 一 siz; 
unsigned char cylind_num ； 
unsigned char head_num; 
unsigned char sector^num ； 
unsigned char *data_buf5 

} DISK _ IHFO ; 


/* DISK コマンド*/ 

/* 実行後の状鱸 */ 

/* デバイスタイプ/ュニッ ト番得 */ 

ド データサイズ*/ 

/* セクタサイズ*/ 

/* シリンダ 番号 */ 

/* へ ，ド 響 #*/ 

/* セクタ 響 #*/ 

/* データ 罐 */ 
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コマンドを実行した結果は，16ビット中の下位8ビットに設定され返さ 
す。また，バケット内のメンバ stus にも格納されます。 

パケット内のデータの授受 

1 MB /640 KB フロッピィディスクの 場合： 
























機能コード （ DISK コマンド）は以下のような意味を持っています。 


番号コマンド 


コード 

lMB /640 Kb 320 Kb 


1 

READ DATA 

0 xT 6 

0 x 06 

2 

WRITE DATA 

Ox 丁 5 

0 x 05 

3 

SEEK 

OxUO 


4 

RECALIBRATE 

0 xV 7 


5 

FORMAT DRIVE 


OxOC 

6 

INITIALIZE 

0 x 03 

0 x 03 

7 

VERIFY 

OxTl 

0 x 01 

8 

SENSE 

0 x 04 

0 x 04 

9 

READ ID 

OxWA 


10 

WRITE DELETED DATA 

0 xT 9 


11 

READ DELETED DATA 

OxTC 


12 

READ DIAGNOSTIC 

0 xW 2 


13 

SET OPERATION MODE 


OxOE 

14 

FORMAT TRACK 

OxWD 



上の表のコード使われているサブコマンド（上位4ビット）は以下のよう 
な値と意味を持っています。 



上位 4 ビッ 

卜 


T 

MT MF 

r 

SK 

U 

0 0 

r 

1 

V 

0 0 

r 

0 

W 

0 MF 

r 

SK 


ビット 

脱明 

MT 

トラック指定 

MF 

密度指定 

r 

再試行指定 

SK 

シーク指定 
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dinf.comd _ OxDA 

din[ device 一 typ ■ 0x90 
dinf.8ector_8iz - - 1 ; 
dinf•cylind_num - c ； 
dinf.head num - h; 
dinf.8ector_num - - 1 ； 
bio898disk(&dinf)5 
dinf.crand - 0xD6; 
dinf*data_8iz -1024 
dinf.sector num _ s; 
dinf•data_buf ■ buf ； 
bio898di8k(idinf); 
printfC8tu8-Z02X f CY- 
dinf.stu8, din 
dinf.sector nu 


void main() 


bios98equip 


携能 

システム情報を取得します 0 

形式 

# include < bios 98. h > 


unsigned bios 98 equip ( void )； 

プロトタイプ 

bios 98 .h 


解脱 bios 98 equip は，現在システムに接続されている機器悄報を返します。 

注記：この関数は BIOS インターフェースではありません。 

戻り値 16ビット中に下記のように情報が返されます。 


ビット 

名前 

意味 


15 

GPIB ボード 

0:なし 

1:あり 

14 

拡張 RS -232 C ボード 

0:なし 

1:あり 

13 

サウンドボード 

0:なし 

1:あり 

12 

未使用 



11-08 

接統ドライブ数 

〇〜15 


07-04 

クロックモード 

0 : 5 MHz 

3 : 12 MHz 



1: 8 MHz 

4 : 16 MHz 



2 : 10 MHz 


03-01 

CPU タィプ 

0 : 8086 

2 : 80286 



1: V 30 

3 : 80386 

00 

キーボードタイプ 

0:従来型 

1:新型 
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bios98harddisk 


機能 ハードディスクを操作します。 

形式 # include < bios 98. h > 

unsigned bios 98 harddisk(HARDDISK INFO * hdk ) \ 

プロトタイプ bios 98 .h 

解脱 bios 98 harddisk は， ハー ドデ ィス クを直接制御するためのインターフェー 

スです。 

パヶット引数/^ A : 内のメンバ cmmd により各棟のコマンドを実行します。 
構造体 HARDDISK INFO は， bios 98 .h の中で次のように定義されてい 
ます。 


typedet struct { 

unsigned char cmrod; 
unsigned char stus; 
unsigned char device typ ； 
unsigned int data_siz ； 
unsigned int cylind 一 num; 
unsigned char head 一 num; 
unsigned char sector 一 num; 
unsigned char *data_buf; 

} HARDDISK INFO ; 


/* DISK コマンド*/ 

/* 実行後の状想*/ 

/* デバイスタイプ/ユニット褥婦*/ 
I * データサイズ*/ 

/* シリンダ番等*/ 

/* へッド番号*/ 

/* セクタ番号*/ 

/* データ域*/ 
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戻り値 各コマンドを実行した結果は， 16 ビット中の下位 8 ビットに設定され返され 

ます。また，パケット内のメンバ stus にも格納されます 0 

■パケッ ト内のデータの授受 


HARDDISK INFO 

1 

2 

4 

5 

6 

7 

8 

14 

15 

16 

17 

cmmd 

AH 

R 

R 

R 

R 

R 

R 

R 

R 

R 

R 

R 

stus 

AH 

W 

W 

W 

w 

W 

W 

W 

W 

W 

W 

W 

device typ 

AL 

R 

R 

R 

R 

R 

R 

R 

R 

R 

R 

R 

data siz 

BXBH 

R 

R 

X 

Rx 

X 

R 

X 

Rx 

R 

R 

X 

cylind num 

CX 

R 

R 

X 

R 

x 

R 

X 

R 

R 

R 

X 

head_num 

DH 

R 

R 

X 

R 

X 

R 

X 

R 

R 

R 

X 

sectornum 

DL 

R 

R 

X 

R 

X 

R 

X 

R 

R 

R 

X 

databuf 

ESBP 

R 

R 

X 

X 

X 

R 

X 

X 

R 

R 

X 


機能コード （ DISK コマンド）は以下のような意味を持っています 0 


番号コマンド コード 


1 

READ DATA 

0xX6 

2 

WRITE DATA 

0xX5 

4 

RECALIBRATE 

0xX7 

5 

FORMAT DRIVE 

Ox YD 

6 

INITIALIZE 

0x03 

7 

VERIFY 

OxXl 

8 

SENSE 

0x04 

14 

FORMAT TRACK 

OxZD 

15 

ASSIGN ALTERNATE TRACK 

0x08 

16 

FORMAT BAD TRACK 

OxOB 

17 

RETRACT 

OxXF 
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上の表の コード 使われているサブ コマンド （上位 4 ビット）は以下のよう 
な値と意味を持っています。 


上位 4 ビット 

X 

X 

X 

r 

X 

Y 

1 

X 

r 

X 

Z 

0 

X 

r 

X 


ビット 

脱明 

r 

再試行指定 

X 

意味なし 
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bios98key 


機能 キーボードインターフェースです。 

形式 # include < bios 98. h > 

void bios 98 key(KEYJNFO * key ) : 

プロトタイプ bios 98 .h 


解脱 bios 98 key は，入力待ちのキーデータの統み出し，人力待ちなしキーデータ 

の统み出し，シフトキーの押下チェック，キーボードインターフェースの 
初期化，グループわけされたキー配列のキー入力状態のセンスなどを行な 
います。 


W 造体 KEY INFO は， bios 98. h の中で以下のように定義されています。 


typedef struct { 
unsigned char 
unsigned char 
unsigned char 
unsigned char 
unsigned char 
unsigned char 
unsigned char 
} KEY_INFO; 


coukI ； 

8tU8； 

scan 一 code; 
inter code; 
shift_code; 
group 一 num; 
group 8tU8; 


/* 檐能 コード */ 

/* 実行後の状態 */ 

I* スキヤンコー K */ 

/* 内部 コード */ 

I* シフトコード */ 

/* グループ番 得*/ 

/* グループビット 情報*/ 


この関数の実行中は， STOP キーは完全に無視されるようになっています。 


戻り値 機能コードが0のとき，人力されたキーコードを返します。16ビット中の上 

位8ビットはスキャンコードで16ビット中の下位8ビットは内部コードです。 
また，パケット内のメンバにも値が格納されます。 

機能コードが1のとき，キーが解放状態のときは0を返し，キーが押下状態 
のときはそのキーコードを返します。16ビット中の上位8ビットはスキャン 
コードで16ビット中の下位8ビットは内部コードです。また，パケット内の 
メンバにも格納されます 0 

機能コードが2のとき，シフトキー押下情報を返します。16ビット中の下位 
8ビットに下記のように悄報を返します。また，パケット内のメンバにも格 
納されます。 
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b7 

b6 

b5 

b4 

b3 

b2 

bl 

bO 

0 

0 

0 

1 

■ 

ii 

— T— J 

i 

i 

i 


1 ~> SHIFT キー押下時 

-- CAPS キー押下時 

-^カナキー押下時 

- - QRPH キー押下時 

-- CTRL キー 押下時 

機能コードが 3 のとき，戻り値は意味を持ちません。 

機能コードが 4 のとき，変数 groupnum のキーコードグルーブに対応する 
ビット悄報を返します。 16 ビット中の下位 8 ビットはキーの状態を示してい 
ます。また，パケット内のメンバにも格納されます。 

■ハ•ケッ ト内のデータの授受 


KEY INFO 

0 

1 

2 

3 

4 

cmmd 

AH 

R 

R 

R 

R 

R 

stus 

BH 

X 

W 

X 

X 

X 

scan 一 code 

AH 

W 

W 

X 

X 

X 

inter code 

AL 

W 

W 

X 

X 

X 

shift code 

AL 

X 

X 

w 

X 

X 

groupjium 

AL 

X 

X 

X 

x 

R 

group_stus 

AH 

• X 

X 

X 

X 

W 
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例 


#include <bios98.h> 


voia mam() 


int 

tins 

KEY 


igned key f sft 
_INFO kinf; 


キーボー K の初期化 


キー入力 


kinf.cmmd - 3; 

bio898key(&kinf); /* 

pxrintf (• キーを待してください。 ¥n*); 
kinf•cmmd - 0 ； 

key _ bio898key(&kinf); /* 

kinf-cmmd - 2; 

8ft _ bios98key(&kinf); /* シフトキーのセンス */ 

printf (• スキヤンコードは Z02X f 内部 コードは 202X です。 ¥n_ 
key / 256 • key Z 256); 
printf (•シフトキー 状！！ は Z02X です。 ¥n* f sft )； 
do { 

printf (• キーセンス中 • 
kinz.cmmd * 1 ； 

key - bio898key(&kinf) ; /* キー入力 */ 

} while (key ― 0); 

printf (• スキヤンコードは I02X f 内部 コードは Z02X です〇 ¥n ， 
key / 256, key I 256); 

i - 0; 
do { 

kinf.cniDd - 4; 
kinf.group_num - 

key - bios98key(ikinf); /* キーグループセンス */ 
printf (•キーグループ Z02X, 対応ビブト Z02X¥n_ • i, key); 
i++; 

)while (i < 16 ); 
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bios98memory 

機能 実装メモリのサイズを調べます。 

形式 # include く bios 98. h > 

unsigned bios 98 memory ( void )； 

プロトタイプ bios 98 .h 

解脱 bios 98 inemory は，現在使用しているシステムのメインメモリサイズを返 

します。この関数は，メモリスイッチ （ bio 8 98 msw を参照）のメモリサイ 
ズをチェックするのではなく，実メモリサイズをチェックします。 

注記：この関数は BIOS インターフヱースではありません。 

戻り値 128, 256，384, 512, 640のいずれかを返します。単位は K バイトです。 

例 /include <bios98.h> 

void main() 

{ 

printf (•システムのメモリは ZdKb です 0 ¥n- f bio898memory()); 
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bios98mouse 


機能 マウスの制御を行ないます。 

形式 # include < bios 98. h > 

void bios 98 mouse(MOUSE INFO * msf ) ； 

プロトタイプ bios 98 .h 

解脱 bios 98 mouse は，カーソル位 S の取得，カーソノ ufi ： 置の設定，左ボタン押 

下悄報の取得，左ボタン解放情報の取得，右ボタン押下情報の取得，右ボ 
タン解放情報の取得，マウス移動距離情報の取得などのマウスの動作に関 
するコマンドを実行します。また，環境の初期化， カーソル 表示， カーソ 
ル 消去などはどちらの関数で利用してもかまいません。 

構造体 MOUSE INF 0 は， bios 98. h の中で以下のように定義されていま 
す。 


typedef struct { 


unsigned 

unsigned 

char 

cmnd; 

1* 

擔齟コード 

*1 

char 

8tU8 : 

1* 

実行後の状® 

*/ 

char 


1ft 一 buton 

/* 

友ボタンの状態 

貪/ 

char 


rgt_buton 

1* 

右ボタンの状態 

*/ 

unsigned int 

Ift_count 

1* 

友ボタンの} f 下/解放回败 

食/ 

unsigned 

int 

rgt count 

1* 

右ボタンの抒不/解放回败 

*/ 

unsigned 

int 

abs_h crs 

1* 

カーソルの水平_廑標 

*1 

unsigned 

int 

abs_v_crs 

/* 

カーソルの * 直_廑標 

*/ 

int 


rel_h 一 crs 

1* 

カーソルの相対水平_«標 

*/ 

int 


rel v crs 

1* 

カーソルの相対水直_*標 

*/ 


} MOUSE INFO; 


注意：この関数は，日本電気が提供しているマウスドライバを利用してい 
ます。したがって使用する場合は，必らず CONFIG.SYS にマウスドライバ 
( MOUSE . SYS ) を組み込むこんでおいてください。 
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内のデータの授受 



閲連項目 bios98mouse init 
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static unsigned char mouse_patt[] ■ { 


>； 


void mou8efun(int stus f int 1ft 一 buton, int rgt_buton f 

unsigned abs 一 h crs, unsigned abs v crs) 
switch (8tU8) { 


case 

1 

# 

/* 

"• * 

case 

2 

: 

/* 

• • • * 

case 

4 

: 

/* 

# " * 

case 

8 

• 

• 

/* 

• • • * 

case 

16 

t 

/* 

•… * 


void main() 


マウス描写面面の設定 


MOUSE_INIT mint; 

MOUSE_INFO minf; 
mint.cinnd _ 0; 

bio898mou8e_init(&mint); /* マウス環塊の初期化 */ 

mint.cmmd _ 18; 
mint.plane_num - 1; 

bio898mou8e_init(imlnt); /* マウス描写 ■ 面の設定 */ 

mint.cmrod - 9; 

mint.crs_h_ba8_0; mint•crs v bas ■ 0; 
mint.cr8_pat_p - mouse_patt; 

bio898mou8e_init(&mlnt); /* カーソル形状の！^定 */ 

mint.cmmd - 15; 

mint.md_h_8ca _ 2; mint.md 一 v sea _ 2; 

bios 色 I* ミツキー/ドツト比の投定 
mint.cmmd _ 12; 

、 mlnt.call_cond - OxlF; 

mint.mou8e_fun - mousefunc ； 

^bio898mou8e_init(&mlnt); /* M 数置鎌 */ 

mlnf.cnnKl - 4; 

minf .ab8_h_cr8 - 300; minf• abs v crs - 200; 

"Bio898mouse(imlnf) 5 /* マウスカーソル位置校定 * 

< mint • cmnd _ 1; 

bio898mou8e_init (imint) : /* マウスカーソルの裹示 */ 

mTnf. crand _ 5; 

Mo898mouse(&minf); /* 左ボタン持下の取得 */ 

sprintf ( • L-Id f LC_:d • H_Zd ノ V_Zd¥n • • 

minf.Ift_buton f minf.lft 一 count, 
minf•ab8_h_cr8 f minf•abs v crs); 

、 1* … *1 

minf-cmmci _ 8; 

bio898mou8e(&mlnf); /* 右ボタン解放の取得 */ 

、 prlQtf(_R_:d, RC_Zd, H-Id f V-Zd¥n» f 

minf•rgt_buton, minf.rgt count, 
minf.abs h crs, minf•abs v crs); 


Mftft 錄 


/* マウスカーソル位置 » 定 
/* マウスカーソルの裹示* 


mint.cmmd ■ 2 ; 
bio898mou8e_init(4mint) ; 
mint.cmnd - 0 ； 
bio898mou8e init(&mint); 


マウスカーソルの消去 
マウス環境の初期化* 
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bios98mouse」nit 


機能 マウスの初期化を行ないます。 

形式 # include < bios 98. h > 

void bios 98 mouse init ( MOUSE_INIT * msi ) : 

プロトタイプ bios 98 .h 


解脱 bios 98 mouse _ init は，カーソル表示画面の設定，水平軸方向のカーソル移 

動範囲の設定，垂直軸方向のカーソル移動範囲の設定，ミッキー/ドット比 
の設定，カーソル形状の設定，ユーザ定義の割り込みルーチンを登録など 
の初期化に関するコマンドを実行します。 

構造体 MOUSE INIT は， bios 98 .h の中で以下のように定務されていま 
す。 


typeder struct 
unsigned cha】 
unsigned chai 
unsigned int 
unsigned int 
unsigned int 
unsigned int 
unsigned int 
unsigned int 
unsigned int 
unsigned int 


cmmd; 

8tU8 ； 

plane 一 num; 
min_h_po8; 
max_h_po8; 
min_v_pos; 
max_v_po8; 
md__h_scal; 
md_v_8cal; 
crs h bas; 
crs v bas; 


unsigned int crs 一 v bas; 

unsigned char *crs_pat 一 p; 
unsigned int call_cond; 
void (*mou8e_fun)()5 
MOUSE INIT ; 


/* 檐齟コード ♦/ 

/* 実行後の状態 */ 

/* カーソルの表示■面 */ 

/* カーソル水平輪の下限界 ♦/ 

/* カーソル水平_の上限界 */ 

I * カーソル*■[輪の下限界 *1 

I * カーソル•直_の上限界 */ 

/* 水平_のミツキー/ドツト比 */ 

I * 蠹直輪のミツキー/ドツト比 */ 

I * マウスカーソル水平輪の基点*/ 
ト マウスカーソル•直_の基点*/ 
/* マウスカーソルの形状を指す*/ 
/* 割り込み条件 */ 

/* 割り込み I # に起動する関数 */ 


機能コード12の“ユーザ定義のサブルーチンの登録”において，ユーザ定義 
の割り込みハンドラを呼び出す形式は下記の通りです。 


void mouse fun(int 8tus f /* 1,2,4,8.16:® 因*/ 


int lft_buton, /* 0 : 解放， -1 :抒 下*/ 

int rgtjmton, /* 0 : 解放 •-1 : 柙 下*/ 

unsigned abs h crs, /* 〇〜 639 */ 
unsigned abs_v 一 crs); I* N : 〇〜 199, H: 〇〜 399 貪 / 
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この中で， N はカラーモード， H は高分解カラーモードを表わします。 

なお，ユーザ定義の関数内で実行できる処理は下記のような制約を受けま 
す0 


■ DOS システムコールを発行してはいけません。 DOS システムコール 

を処理中でなければかまいません （ C 標準ライブラリ， C 非標準ライブ 

ラリの関数はこれらを使用しているものがあるので充分注意してくだ 
さい)〇 

■ ROM - BIOS コールはできるだけ使用を避けてください。 

■タイニイ，スモール，ミディアムモデルでは自動 （ aut0 ) の列や構 
造体は使用してはいけません。これは，割り込みが発生するタイミン 
グは常にユーザ定義のブログラムが稼働しているときだけではなく， 
システム側のタスク（敢小単位の意味ある処理工程）が起動している 
ときでも発生するからです。 

割り込みがシステム側のタスク内で発生したときは，スタックセグメ 
ント ( SS ) がシステム側の領域を指しているため不具合が生じます。 
タイニイ，スモール，ミデイアムモデルでは DS , ES , SS セグメントレジ 
スタは常に同一領域を示していなければならないという規則がありま 
す。 DS . ES セグメントレジスタに関してはユーザ定義の割り込み ハン 
ドラに制御を渡す前に，ユーザ定我のブログラム側の領域を指すよう 

にしてあります。静的 （ static ) 変数，単独の自動 ( auto ) 変数は利用 
できます。 

なお，コンパクト，ラージ，ヒュージモデルではこうした制約なしで 
利用できます。 

■ setjmp , longjmp は使用できません。 

■割り込みハンドラが使用するスタ ッ クは，システム側のスタ ッ クか利 
用者側のスタックか解らないので，関数の呼び出しのネストを深くし 
ないようにしてください。 

また，コンパイルの際には，スタックオーハ•ー フロー チェックのオプ 
シヨン （- N ) はつけないでください。 

この 機能 コードの使用に関して，利用者が作成したブログラムを終了させ 
るときには，再度マウス環境を初期化しなければなりません。初期化して 
おかないと，ブログラム終了後，マウスに触れただけでシステムが暴走す 
るので注意して使ってください。 
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主意：この関数は，日本電気が提供しているマウスドフ 
ます。したがって使用する場合は，必らず CONFIG.SYS 
( MOUSE . SYS ) を組み込むこんでおいてください。 



閱連項目 bios 98 mouse 

例 bios 98 mouse を参照してくた 


PC -9801 の ROM-BIOS イン ターフェー ス 




bios98msw 


機能 メモリスイッチ情報を得ます。 

形式 # include < bios 98. h > 

unsigned bios 98 msw(MSW INFO * msw ) \ 


プロトタイプ bios 98 .h 

解脱 bios 98 msw は， PC -9801 シリーズ上のメモリスイツチ悄報の読み出し，更新 

を行ないます。更新の際には，本体のディップスイッチ SW 2 の5が ON に 
なつている必要があります。 SW 2 の5が OFF になっていると，本体の苽源 
を再投入したときにメモリスイッチが初期化されてしまうため，メモリス 
イッチへの冉き込みを行なっても情報が失われてしまいます。 

引数 sw_num には卜6の整数を指定し，それぞれメモリスイッチの 
SW 1 〜 SW 6 に対応します。 

怫造体 MS \ V_INFO は， bios 98 .h で以下のように定義されています。 

typedef struct { 

unsigned char cmmd; 
unsigned char stus : 
int sw 一 nu 

unsigned char value 
} MSW _ INFO ; 

機能コード 1 は指定したメモリスイッチの読み出し，機能コード2は指定し 
たメモリスイッチの辨き出しになります。 

注記••この関数は BIOS インターフェースではありません。 


I * 禳齟コード */ 

/* 実行後の状態 */ 

/* メモリスイツチ番婦 */ 
/* メモリスイツチの内 **/ 


656 


第 2章 Turbo C ライブラリ 


戻り偭 


機能コードが1のとき，指定されたメモリスイッチ情報を返します。また， 
ハ。 ケット内のメンバにも格納されます。 

機能コードが2のとき，引数 value の値を返します。 swnum の値が不正な 
ときは-1を返します。 

■ハ•ケッ ト内のデータの授受 


MSW INFO 

1 

2 

cmmd 

R 

R 

stus 

X 

X 

sw num 

— 

R 

R 

value 

W 

R 


例 


# include <bios98.h> 


void main() 

{ 

unsigned stuss 
int i; 

MSW INFO minf; 


for <i _ 1;i <_ 6; i++) { 
minf .crand - 1 ; 
minf•8w_num - 1; 

8tU8 _ bio898m8v(&minf) : 
printfCSWId - 202X-¥n* f 


minf.cnind - 2 ： 


• cmmd 

• 8w n\ 


minf•8w_num 麵 6; 
minf.value _ 0x14; 
stus ■ bio898m8w(iminf); 
printf(-SW6 - Z02X.¥n B f stus) 


/* 豌み出し 
stus); 


/* 書き込み 



*/ 
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bios98print 


機能 プリンタインターフェースです。 

形式 # include く bios 98. h > 

unsigned bios 98 print(PRINT INFO * prt ) : 

プロトタイプ bios 98 .h 


解脱 bios 98 print は，ブリンタコントローラの初期化，プリンタステータスの取 

得，1文字単位の出力，文字列単位の出力に使用します。 

怫造体 PRINT_INFO は， bios 98 . h の中で以下のように定我されていま 
す0 


typedef struct { 

unsigned char cmnd; 
unsigned char stus; 
unsigned char chr; 
unsigned char *8tring; 
unsigned char *8trings 
> PRINT INFO ; 


/* 檐®コード */ 

/* 寅行 後の 状態 */ 

/* 出力 文字 */ 

/* 出力 文字列を指す ポインタ*/ 
/* 出カサイズ *1 


戻り価 機能コードが16および18のときは，16ビット中の下位1ビットに，ブリン 

夕に対して送信可能かどうかの状態を返します。また，パケット内のメン 
バにも格納されます。 



ンタへの送信が可能 



機能コードが17のときは，16ビット中の下位2ビットにプリンタへの送信状 
態を返します。また，パケット内のメンバにも格納されます。 


b 7 b 6 b 5 b 4 b 3 b 2 bl bO 


出力終了，次データ送信可能 
タイムアウト，現データ未送信 


機能コードが48のときは，ビット bl にタイムアウト悄報を返し，正常終了 
のときは，バケツト内のメンハ • string およびメンバ size は不定となりま 
す。タイムアウト時にはメンバ string に未送信のデータの先頭アドレスを 
返し，メンバ size に未送信のデータ長を返します。 


b 7 b 6 b 5 b 4 b 3 b 2 bl bO 


x x x x 


x 


タイムアウト時 


■バケツト内のデータの授受 


PRINT INFO 

16 

17 

18 

48 

cmmd 

AH 

R 

R 

R 

R 

stus 

AH 

W 

W 

W 

W 

chr 

AL 

X 

R 

X 

x 

string 

ESBX 

X 

X 

X 

RW 

size 

CX 

X 

X 

X 

RW 
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void main() 


unsigned status; 

PRIHT_INFO pinf; 

pinf.cmmd -16; 

status - bio898print(&pinf); 

/* プリンタコント □- 
if ( I (status & 0 x 01 ” { 

printf (•プリンタの準備をしてください。 ¥n 

pinf•cnmd ■ 18 ; 

status - bio898print( &pinf); 

/* プリンタスラ 

> 

do { 

pinf•cmmd - 17; 
pinf.chr - ’A ’； 

status _ bio898print(&pinf) : /* 1 文字 

if (丨 (status & 0 x 01 )) 

printf (• プリンタの電潭を入れてくださ l 
if (status & 0x02) 

printf (•用紙切れ準備中 ハード： L ラー。 
} while (status 1 _ 0 x 01 )j 
pinf .cmnKi - 48; 
pinf•string _ B ABCDE* 5 
pinf•size • 5s 

status - bio898print(&pinf); /* 文字列出 3 
if (status & 0x02) { 

printf (• タイムアウトが発生しました。 ¥n_) 
printfCZs の文字列が Zd バイト分未送信です 
pinf.8tring f pint.size); 



bios98stoptimer 


s 能 割り込みハンドラを切り放します。 

•式 void bios98stoptimer(void); 

プロトタイプ bios98.h 


脱 bios98stoptimer ti t ユーザブログラムを終了する際に， bios98timer によ 

つてインストールされた割り込みハンドラを強制的に切り放すときに使用 
します。 

親ブロセスや子ブロセスで同時にタイマ割り込みを使用した場合，ブログ 
ラムの動作は保証されません。 

タイマ割り込みハンドラについては， bios98timer の解説を参照してくだ 
さい。 

り値 ありません。 

連項目 bios98timer 


bios98timer を参照してください《 
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bios98time 


機能 日付時刻の読み出しおよび設定を行ないます。 


形式 # include < bios 98. h > 

void bios 98 time (丁 IME INFO * tim ) \ 

プロトタイプ bios 98 .h 


解脱 bios 98 time は日付時刻の統み出し，日付時刻の設定を行ないます。 


怫造体 TIME INFO は， bios 98. h の中で以下のように定我されています。 


typedef struct { 

unsigned char cmmd; 
unsigned char stus; 
unsigned char year; 
unsigned char month 一 week; 
unsigned char day; 
unsigned char hour; 
unsigned char minute ； 


unsigned char second; 
} TIME INFO; 


/* _« コード */ 

/* 実行後の状 ®*/ 

/* 年 BCD コード 00 〜 99 */ 

/* 月 • 曜日2道败1〜12 , 〇〜6 */ 
/* 日 BCD コード 01 〜 31 */ 

/* 轉 BCD コード 00 〜 23 */ 

/* 分 BCD コード 00 〜 59 貪 / 

/* 秒 BCD コード 00 〜 59 */ 


戻り値 ありません。 


■パケッ ト内のデータの授受 


TIME INFO 

0 1 

cmmd 

AH 

R 

R 

stus 


X 

X 

year 


W 

R 

month week 


W 

R 

day 


W 

R 

hour 


W 

R 

minute 


W 

R 

second 


W 

R 










例 


# include <bios98.h> 

#define BCDtoB(x) ( (x / 16) * 10 + (x Z 16)) 

Idefine BtoBCD(x) ( (x / 10) * 16 + (x Z 10)) 

Idefine GETupr(x) ( x / 16 ) 

/define GETlwr(x) ( z Z 16 ) 

static char *toJPN [ 】 

- { ’日' ■月 •• ■火 _• ■水■木 11 , ■金 11 , 



void main() 

{ 

TIME_INP0 tinf s 
int value; 



tinf.cmmd _ 0 ; 

bios98time( itinf); /* 現 日付轉 の 取得 */ 

printf (•现 日付は Zd 年 Zd 月 Zd 日 (Zs) Zd 轉 Zd 分 Zd 秒 ¥n« • 

BCDtoB(tinf.year) f GETupr(tinf•month_week)• 

BCDtoB(tinf.day) t toJPN 【 GZTlwr (tinfTmonth 一 week) 】 • 
BCDtoB(tinf•hour), BCDtoB(tinf-minute) t - 

BCDtoB(tinf.second) )5 
if (BCDtoB(tinf.second) < 30) 
tinf.second _ BtoBCD(O); 
else { 

tinf.8econd - BtoBCD(O )； 
value _ BCDtoB(tinf•minute) + 1 ； 
if (value < 60 ) 

tinf•minute - BtoBCD(value); 
else { 

tinf.minute - BtoBCD(O); 
value ■ BCDtoB(tinf.hour) + 1 ； 
if (value < 24) 

tinf•hour _ BtoBCD(value )5 
else ( 

tinf.hour - BtoBCD(O); 
value _ BCDtoB(tinf.day) + 1 ； 


tinf .cmmd _ 1 ； 

bi0898time(&tinf) 5 /* 日付！ * « の設定 */ 

pxrintf (• 秒折を補正しました。 ¥n-); 
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bios98timer 

機能 インターバルタイマーインターフェース 

形式 void bios 98 timer ^unsigned interval time, void (* timer June )()) : 

M 連關数 void bios 98 stoptimer ( void ); 

プロトタイプ bios 98 .h 

解脱 bios 98 tiiner は，インターバルタイマの設定と割り込みルーチンの設定を 

行ないます。インターバル時間 interval time \ t % 10 msec 単位で指定してく 
ださい。指定時間後に timer June を1回だけ呼び出します。連絞して割り込 
みを発生させるときは， f/mw ゾ wrn : 内で bio 8 98 timer を呼び出し，自分自 
身を再度登録しなおします。 

ユーザ定莪の timer ゾ wm : の呼ひ•出し形式は次のようになります。 

void timer_func(void ) 5 

ユーザ定義関数内で実行できる処理は，以下のような制約を受けます。 

■ MS - DOS システム コールを 発行してはいけません。 MS - DOS システ 
ム コールを 処理中でなければかまいません （C 標準ライブラリ， C 非標 
準ライブラリの関数はこれらを使用しているものがあるので充分注意 
してください）。 

■ ROM BIOS コールはできるだけ使用を避けてください。 

■タイニィ， スモール， ミディアムモデルでは自動属性 ( auto ) の配列 
や構造体は使用してはいけません。これは，割り込みが発生するタイ 
ミングは，ユーザ定義のブログラムが稼働しているときだけではなく， 
システム側のタスク（最小単位の意味ある処理工程）が起動している 
ときでも発生するからです。 

割り込みがシステム側のタスク内で発生したときは，スタックセグメ 
ント ( SS ) がシステム側の領域を指しているため不具合が生じます。 
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タイニイ，スモール，ミデイアムモデルでは DS , ES , SS セグメントレジ 
スタは常に同一領域を示していなければならないという規則がありま 
す0 DS , ES セグメントレジスタに関してはユーザ定義の割り込み ハン 
ドラに制御を渡す前に，ユーザ定義のブログラム側の領域を指すよう 
になっています。静的 ( static ) 変数，単独の自動 ( auto ) 変数は利用 
できます。 

なお，コンパクト，ラージ，ヒュージモデルではこうした制約なしで 
利用できます。 

■ setjmp, longjmp は使用できません。 

■割り込みハンドラが使用するスタックは，システム側のものか ユーザ 
側のものかは解らないので，関数の呼び出しネストを深くしないよう 
にしてください。 

また，コンパイルの際には，スタックオーバーフローチェックのオブ 
シヨン （- N ) はつけないでください。 

ユーザ定我のブログラムを終了する際に，割り込み ハン ドラを強制的に切 

り放すには， bios988toptimer を使用します。 

戻り値 ありません。 

間連 項目 bios98stoptimer 
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例 


# include <bios98.h> 
static int clock; 
static int delay on; 


void timefunc() 

{ 

clock++; I* 1 秒 力 

bio898tlmer(100 f timefunc); /* 褥度， 

} 

void delayfunc() 

{ 

delay 一 on++; 

) 


void delay(unsigned milliseconds) 

{ 

delay_on - 0; 

bios98timer( milliseconds / 10• delayfun 
whiled) 

if (delay on > 0) break; 


void main() 

{ 

clock - 0; 

bio898timer(100 f timefunc); 
while (1){ 

printf(•Zu,® f clock); 
if (clock > 1000 ) break; 

> 

bios988toptimer(); 



/*1 秒後 

/* 割り込 
/*10 秒問 
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getfont 

機能 

形式 

ブ a トタイプ 

機能脱明 


ROM のフォントパターンを読み出します 0 

voia getfont (unsigned int code , unsigned char * font ) \ 


dos.h 


getfont は，マシンの ROM に組み込まれているフォントパターンを読み 
出します。引数で指定されたコードに対応するフォントビットイメ 
ージをバッファ介がに格納します。 

引数/〇加のレイアウトは次のようになります。 


-font 


最大32バイト 


hh 


WW 

① 

② 

③1④ 

⑤® 


#參 • 

• • • 

• • • 


各1バイ 


• ww バイ 


hhx 8 


① 

② 

③ 1 

④ 

⑤ 

⑥ 

• • • 

• • • 


hh :フォントの高さ ww :フォントの幅 
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ズの最大長は 34 八 



,,引数⑺ 




下位 





HCRT ： 商解像度 CRT 
NCRT :標準 CRT 
ANKc : 8ビット JIS コード 
shift-JISc :シフト JIS コード 

OxXX :有効な8ビット JIS コード 


この関数は， PC -9801 の CRT - BIOS を使用しています, 


戻り価 


ありません。 


可搬性 


この関数は PC -9801 シリーズでのみ動作します。 


関連項目 putuserfont 
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例 


#define HH gb[OJ * 8 
#define WW gb[l] 
#define FT(x) gb[2 + (x)] 


void main() 


int i f w f h ； 
unsigned char gb[64]; 

getfont(0xEB9F f gb); / 

for ( h - 0 ; h < HH ； h++ ) { 
printf( ■Z02X' h); / 

for ( w _ 0; w < WW ； w++ ) { 
for ( i - 0; i < 8; i++ ) { 

if (((FT(h*W + w) « i) & 0x0080) — 0x0080) 
printfC #-)； /* ビット オンの 表示 */ 


フォントの蹺み出 
行番考の表示 */ 


else 

printf CO-) 


ビツトオフの表示 


printf( m Vn 


2 
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putuserfont 


機能 

形式 

プロトタイプ 

機能脱明 
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ユーザフォントハ。ターンを定義します 0 


void putuserfont (unsigned int code, unsigned char 木 font ) : 


dos.h 


putuserfont は，ユーザが作成したフォントバターンをマシンのフォント 
浮用 RAM に定義します。定義できる文字の大きさは全角のみです。引数 
code で指定されたコードに対応するフォント详用 RAM に，バッファ/加/ 
内のフォントビットイメージを格納します 0 

引数/0打/のレイアウトとフォント領域の関係は次のようになります。 


-font 


32バイ 


[dd [dd] ① 1 ② f ③「④了⑤|⑥ 


• • • 


各1バ 


16バイト 
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戻り値 
可搬性 

間連項目 

例 


引数はシフト JIS コー ドで指定します。ユーザが定義できる コード 
の種類は機種ごとに異なり，次のとおりです。 


マシンタイプ JIS シフト JIS 


UV/VF/VM 0x762 卜 0x767E 0xEB9F 〜〇 xEBFC 

0x7721 〜 0x777E 0xEC40 〜 0xEC9E 
E/F/U2 0x7621 〜 0x765F 0xEB9F 〜〇 xEBDD 


この関数は PC-9801 の CRT-BIOS を使用しています。 

ありません。 

この関数は PC-9801 シリーズでのみ動作します。ただし PC-9801 の辰初期 
型では動作しません。 

劣 etiont 

static unsigned char fontp[] - { 


0x00 f 

0x00 f 







Oxff • 

Oxff • 

Oxff t 

Oxff, 

0x80 • 

0x80 f 

0x80 f 

0x80 9 

0 x 80 f 

0x80 1 

0 x 80 1 

0x80 f 

0x80 1 

0x80 1 

0x80 f 

0x80, 

0x80 1 

0x80 f 

0x80 • 

0x80 f 

0x80 f 

0x80 • 

0x80 f 

0x80 • 

0x80 f 

0x80 f 

0x80 f 

0x80 f 

0x80 f 

0x80 f 

0xff t 

Oxff 


void main() 

{ 

putueerf ont (0xEB9P f fontp); /* フォントの定義 */ 
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IBM PC の ROM-BIOS インターフェース 


IBM PC 用 ROM - BIOS インターフェースルーチンは，マシンの ROM チップに組み込 
まれている ハー ドウヱア基本制御ルーチンを駆動するためのインター フヱー スルーチン 
です。これらの関数を使用すれば，マシンの機能を最大限に引き出すことができます。 
ただし，他機棟との互換性はまったくないので，可搬性のあるブログラムを作成しよう 
とするのであれば，このインターフェースは使用すべきではありません。ここで説明 
するすべての関数は ， IBM PC シリーズでのみ使用することができます。 


bioscom 


機能 シリアル I / O を操作します。 

形式 int bioscom (int cmd, char abyte, int port) \ 

プロトタイプ bios.h 

解脱 bioscom は， port に与えられた I/O ポートを通じて，さまざまな RS -232 コ 

ミュニケーシヨンを行ないます。 

/W/ の値〇は COM1 に，値 1 は COM2 に，というように対応しています。 
am / の値は，以下のいずれかになります。 

〇 コミュニケーシヨンパラメータを夕 fe の値にセットします。 

1 abyte 中の文字を通信回線を通して送信します。 

2 通信回線から1文字を受信します。 

3 コミュニケーシヨンボートの現在のステータスを返します。 

_ e は， 以下のビットの組み合わせです（各グルーブ中から1つの値が選 
択されます)。 
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戻り値 


0 x 02 

データビット7 

0 x 00 

110 ボー 

0 x 03 

デー 

タビット8 

0 x 20 

150 ボー 




0 x 40 

300 ボー 

0 x 00 

ス ト 

ッブビット1 

0 x 60 

600 ボー 

0 x 04 

スト 

ッブビット2 

0 x 80 

1200 ボー 




0 xA 0 

2400 ボー 

0 x 00 

ノー 

パリティ 

0 xC 0 

4800 ボー 

0 x 08 

奇数バリティ 

0 xE 0 

9600 ボー 

0 x 18 

偶数 

パリテイ 




たとえば， a 知 / e に0父£8(0\£0丨0\08丨0\00丨0父03)を与えると，コミユ 
ニケーシヨンボートに，9600ボー，奇数パリティ，ストップビット1,デー 
タビット8をセットすることになります。 bioscom は ， BIOS 0 x 14 割り込み 
を使用します。 


am / のすベての値に対して， bioscom は16ビット整数を返します。このう 
ち，上位8ビットはステータスで，下位8ビットは am / の値によって変化し 
ます。戻り値の上位8ビットは次のように定我されています。 


ビット15 

タイムアウト 

ビット14 

トランスミットシフトレジスタが空 

ビット13 

トランスミットホールドレジスタが空 

ビット12 

ブレークを検出 

ビット11 

フレームエラー 

ビット10 

ハ •リテイエラー 

ビット9 

オーノ *c ーラ ン エラー 

ビット8 

データレディ 


aft パ e の値が送信できなかった場合は，ビット15がセットされます。そうで 
ない場合には，残りのビットおよび下位8ビットは適切な値にセットされま 
す。 

cm ゴの値が2 ( 受信）の場合，エラーがなければ，読み込まれたバイトは戻 
り値の下位ビットにあります。エラーがあった場合は，上位8ビット中の少 
なくとも1つがセットされます。上位8ビットがどれもセットされていなけ 
れば，そのバイトはエラーなしで受信されたことになります。 
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am / の値が〇または 3 の場合，戻り値の上位8ビットは上の定義通りにセッ 
卜され，下位8ビットは以下のように定義されます。 

ビット7 受信済み回線信号を検出 

ビット6 リングインジケータ 

ビット5 データセットレディ 

ビット4 クリアトゥーセンド 

ビット3 受信回線信号中の変更検出子 

ビット2 トレーリングエッジリング検出子 

ビット1 データセットレディ中の変更 

ビット0 クリアトゥーセンド中の変更 

可撤性 bioscom は IBM PC とその互換機でのみ動作します。 


例 #include <bios.h> 

# include <conio.h> 

/define C0M10 
#define DATA 一 READY 0x100 

/* 1200 ボー， 7 ビット， 1 ストップ • ノー パリティ */ 
/define SETTINGS ( 0x80 | 0x02j0x00 | 0x00) 

main() 

{ 

int register in, out, status; 



bio8com(0 t SETTINGS, C0M1); 
cprintfC... BIOSCOM [ESC) to exit ."¥n 
while (1) 


status _ bio8Com(3 f 0 f C0M1); 
if (status & DATA_READY) 
if ( (out _ bio8Com(2 f 0 ， 
putch(out); 
if (kbhitO) 


C0M1 )k 0x7F) 


if ( (in _ getchO) ― f ¥xlB 
return(0 )； 

bio8Com(l t in f C0H1); 



I- 0 
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biosdisk 


機能 BIOS のデイスクサービスです。 

形式 int biosdisk (int am /, int drive , int head , int track 、 

int sector , int nsects , void * buffer ) \ 


プロトタイプ bios.h 


解脱 biosdisk は，割り込み 0 x 13 を使用してディスクの操作を BIOS に直接指示 

します。 • 

rfr / ve は，どのドライブを使用するかを指定する数値です。0が1番目のフロ 
ッビィドライブ，1が2番目のフロッピィドライブ，2力<3番目のフロッピィ 

ドライブ， . となります。ハードディスクについては， drive の懷 

0 x 80 が1番目のドライブ， 0 x 81 が2番目， 0 x 82 が3番目， . を指定す 

ることになります。 

ハードディスクに対しては，ディスクのパーティションではなく，物理ド 
ライブを指定します。必要であれば，ユーザブログラム側でハ•ーティショ 
ンテーブルを统み換えなければなりません。 

cmd lt % 実行する操作を示します。の値によって，他のパラメータが 
必要かそうでないかがきまります。 

以下に示したのは ， IBM PC , XT , AT , PS /2， あるいはそれらの互換機 
において有効な cmd の偷です。 

0 ディスクシステムをリセットします。ドライブコントローラを強制 
的にハードリセットさせます。他のパラメータはすべて無視されま 
す。 

1 前回のディスク操作のステータスを返します。他のパラメータはす 
ベて無視されます。 

2 1つ以上のディスクセクタをメモリに読み込みます。読み込む先頭 
のセクタは， head 、 rmcA :, *5 代 Wr によって与えられます。セクタ数 
は/ we 犯で与えられます。データは，1セクタ512バイトで ， buffer 
に害き込まれます。 
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3 1 つ以上のディスクセクタにメモリから害き込みます。害き込む先 
頭のセクタは， head ， track ， 從ぐ⑺;■によって与えられます。セクタ 
数は nsects で与えられます。データは，1セクタ512バイトで ， buffer 
から害き込まれます。 

4 1つ以上のセクタをベリファイします。開始セクタは， head , 
track ， sector によって与えられます。セクタ数は nsects で与えられ 
ます。 

5 1つのトラックをフオーマットします〇トラックは， head と track 
によって与えられます。 buffer は ，指定されたトラック上に件き込 
まれるセクタへッダのテーブルを指します。このテーブルおよびフ 
オーマット操作の詳細については ， IBM PC のテクニカルリファレ 
ンスマニュアルを参照してください。 

以下に示したのは， IBMXT ， AT ， PS /2, あるいはそれらの互換機にお 

いてのみ有効な cmd の値です。 

6 トラックを フォーマッ トし， ハ •ッドセクタフラグをセットします。 

7 指定のトラックからドライブを フォーマッ トします。 

8 現在のドライブパラメータを返します。ドライブ情報は， Aw ガ er 中 
の最初の4バイトに返されます。 

9 ドライブベア性質を初期化します。 

10 ロングリード （1 セクタ512バイト+4エキストラバイト）を行ない 
ます。 

11 ロングライト （1 セクタ512パイト+4エキストラバイト）を行ない 
ます。 

12 ディスクシークを行ないます。 

13 ディスクリセットを行ないます。 

14 セクタバッファを読みます。 

15 セクタバッファを害きます。 

16 指定のドライブがレディかどうかを調べます。 

17 ドライブを再検査します。 

18 コントローラ RAM を診断します。 

19 ドライブを診断します。 

20 コントローラ内部を診断します。 
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注意： biosdisk は，ファイルより下のレベルで，セクタをじかに操作する 
ため，は一どディスク上のファイルの内容やディレクトリを壊してしまう 
可能性があります。 


戾り値 biosdisk は，以下のビットからなるステータスバイトを返します。 

0x00 操作に成功。 

0x01 不正なコマンド。 

0x02 アドレスマークが見つからない。 

0x03 冉き込み禁止ディスクに害き込もうとした。 

0x04 セクタが見つからない。 

0x05 リセットに失敗（ハードディスク）。 

0x06 前回操作以降にディスクが交換された。 

0x07 ドライブバラ メータ の有効化に失敗。 

0x08 DMA のオーバーラン。 

0x09 64K 境界にまたがる DMA を行なおうとした。 

OxOA 不良セクタが検出された。 

OxOB 不良トラックが検出された。 

0x0C サポートされないトラック。 

0x10 ディスク洸み込み中に不正な CRC/ECCo 

0x11 CRC / ECC がデータエラーを修正した。 

0x20 コントローラが動作に失敗した。 

0x40 シーク操作に失敗した。 

0x80 アタッチメントが応答に失敗した。 

OxAA ドライブノットレディ（ハードディスクのみ）。 

OxBB 未定義のエラーが発生（ハードディスクのみ）。 

OxCC ライトフォルトが発生。 

0xE0 ステータスエラー。 

OxFF センス操作に失敗。 

0x11 は，そのデータは正しいのでエラーではないことに注意してくださ 
い0いずれにせよその値は返されるので，アプリケーション側でそれが正 
しいかどうかを決めることができます。 

可撤性 biosdisk は， IBM PC とその互換機でのみ動作します。 
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関連項目 


absread，asbwrite 
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biosequip 


機能 マシンの装備をチヱックします。 

形式 int biosequip ( void ) 1 

プロトタイプ bios.h 

解脱 biosequip は，現在システムに接絞されている機器悄報を返します。 

注意：この関数は BIOS インターフェースではありません。 

戻り値 16ビット中に下記のように悄報が返されます。 


ビット 14-15 組み込まれているハ•ラレルブリンタの数 

ビット13 シリアルブリンタの接統 

ビット12 ゲーム I / O の接統 

ビット 9-11 送信ボートの数 

ビット10 DMA の有無 

0 =マシンは DMA を持っている。 

1=マシンは DMA を持っていない （PC Jr など）〇 
ビット 6-7 デイスクの数 

00 =1ドライブ 
01= 2ドライブ 
10 = 3ドライブ 

11= 4ドライブ（ビット〇が1のときのみ） 

ビット5 イニシャル 

ビット4 ビデオモード 

00 =未使用 

01= 40 X 25 BW ， カラーカードつき 
10 = 80 X 25 BW ， カラーカードつき 
11= 80 X 25 BW ， モノカードつき 
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ビッ ト 2-3 マ ザ ーボー ドの RAM サイズ 

00 = 16 K 
01= 32 K 
10 = 48 K 
11= 64 K 

ビット1 浮動小数点コプロセッサ 

ビット0 デイスクからのブート 

可搬性 biosequip は ， IBM PC とその互換機でのみ動作します。 
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bioskey 

機能 キーボー ドイン ター フニ ースです。 

形式 int bioskey (int cmd ) \ 

プロトタイプ bios.h 

解脱 bioskey は， BIOS 割り込み 0 x 16 を使って，さまざまなキーボード操作を行 

ないます。ハ•ラメータ cm ゴによって行なわれる操作が決まります。 

戻り値 bioskey が返す値は， cmd によって決定される操作に依存します。 


cmd bioskey で行なわれる操作 

0 下位8ビットがゼロでない場合， bioskey は，キュー中に待機して 

いる次のキーストロークの ASCII 文字，あるいはキーボード上 
で次に押されたキーを返します。下位8ビットがゼロの場合は， 
上位8ビットは ， IBM PC のテクニカルリファレンスマニュアル 
で定義されている拡張キーボードコードになります。 • 

1 キーストロークが読み出し可能かどうかをテストします。ゼロの 
戻り値は，キーが読み出し可能でないことを意味します。そうで 
ない場合は，次のキーストロークの値が返されます。キーストロ 
ークそのものは， cmd の値が0の次の bioskey の呼び出しによっ 
て返すために保持されます。 

2 現在のシフトキーのステータスを要求します 9 戻り値は，以下の 
値の OR をとることによって作られます。 

ビット7 0 x 80 Insert オン 
ビット6 0 x 40 Caos オン 


IBM PC の ROM-BIOS イン ターフェース 


681 


可搬性 

例 


ビット 5 

0 x 20 

Num Locfc オン 

ビット 4 

0 x 10 

Scroll Locfc オン 

ビット 3 

0 x 08 

A / f が押されている 

ビット2 

0 x 04 

C 1 T / が押されている 

ビット1 

0 x 02 

& Shift が押されている 

ビット0 

0 x 01 

右 Shift が押されている 


bioskey は ， IBM PC とその互換機でのみ動作します。 

# include <8tdio.h> 

# include <bios.h> 

#include <ctype.h> 


/define RIGHT 0x0001 
#define LEFT 0x0002 
#define CTRL OxOOOA 
Idefine ALT 0x0007 

main() 

{ 

int key f modifiers : 


/* 禳齟 1 はキーが押されるま TO を返します。キーを纗り退し 
チェックすることによつて入力を待ちます。 
while (bio8key(l)— 0) 5 

/* 観 « 〇を使ってそのキーの R り値を得ます 0 

key - bio8key(0) ; 

printf("Key Presses was •)5 



/* 檐 «2 を使ってシフトキーが使われたかどうかを M ベます 


modifiers _ bioskey(2) ; 
if (mofifier8) { 


if 


printfCf); 
if (modifiers 
if (modifiers 
if (modifiers 
if (modifiers 
printfCJ •); 


& RIGHT) printf("RIGHT •); 
& LEFT ) printf CLEFT ■); 

& CTRL ) printf(-CTRL *); 

& ALT ) printfCALT •)； 


(i8alnum(key k OxPP)) 


printfC f Zc f ¥n- f key); 


else 


printf CZ#02x¥n* f key); 
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biosmemory 


捩能 メモリサイズを返します。 

形式 int biosmemory ( void ) ； 

プロトタイプ bios.h 

解脱 biosmemory は， BIOS 割り込み 0 x 12 を使用して ， RAM メモリのサイズを 

返します。これには，ディスプレイアダプタメモリや拡張メモリは含まれ 
ません。 

戻り偭 biosmemory は， 1 K ブロック単位で RAM メモリのサイズを返します。 

可搬性 biosmemory は ， IBM PC とその互換機でのみ動作します。 
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biosprint 


機能 


プリンタ I / O を行ないます, 


形式 


int biosprint (int cmd , int abyte ，int port ) 


プロトタイプ bios.h 


解脱 


biosprint は， BIOS 割り込み 0 x 17 を使って， / wr / で指定されたプリンタに 
対してさまざまな操作を行ないます。 

por / の値〇は LPT 1 に,値1は LPT 2 に，……というように対応しています。 
cmd の値は以下のいずれかです。 


0 夕於中の文字をブリントします。 

1 ブリンタボートを初期化します。 

2 ブリンタステータスを読み出します。 

の値は，0から255の範囲内でなければなりません 


戻り値 


どの搡作における戻り値も，以下のビット値の OR をとって作られ，現在 
のブリンタステータスを示します。 


ノト〇 

0 x 01 

デバイスタイムアウト 

ノト3 

0 x 08 

I/O エラー 

ノト4 

0 x 10 

セレクトされている 

/卜5 

0 x 20 

用紙切れ 

ノト6 

0 x 40 

認識 

ノト7 

0 x 80 

ビジーではない 


可撤性 


biosprint は， IBM PC とその互換機でのみ動作します, 
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biostime 


機能 BIOS タイマの読み出し/設定を行ないます。 

形式 long biostime (int cmd % long newtime ) : 


プロトタイプ bios.h 


解脱 biostime は， BIOS タイマの統み出しあるいは設定を行ないます。これは, 

深夜午前零時から1秒約 18. 2チックのレートで,チックを計測するタイマで 
す。 biostime は， BIOS 割り込み OxlA を使用します。 
cmd が0の場合， biostime はタイマの現在の値を返します。 cmd が1の場合 
には，タイマは newtime 中の long 値にセットされます。 

戻り値 biostime が BIOS タイマを統み込んだとき （ am / = 0) には，タイマの現在 

値が返されます。 

可撤性 biostime は ， IBM PC とその互換機でのみ動作します。 
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PC -9801 サウンドライブラリ 


TurboC のサウンドライブラリは， NEC 製サウンドボード （ PC -9801-26 K ) を增設した 
とき，または PC -9801 UV 2 などに標準実装されているサウンド機能のためのインターフ 
エース ルーチンです。サウンドボードには YAMAHA 製の YM -2203 というシンセサイ 
ザ LSI が搭載されており， FM 音源3声と SSG 音源3声の合計6声による6重和音浈奏が 
浆しめます。 

インターフヱースの詳細な仕様については，サウンドボードのユーザーズマニュアル， 
秀和システムトレーディング株式会社の 「FM 音源スーパーサウンド 」，アスキー出版局 
の 「 PC- 9800 シリーズテクニカルデータブック」 などを ご覧く ださい。 
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図 2.1 は，利用者が作成した MML フォーマットデータ（楽譜に相当する）とサウンド 
BIOS の関係を表わしたものです。 

図 2.1 MML データとサウンド BIOS の関係 


シンセサイザ LSI ① ユーザ側の領域 

YM -2203 f ~ ~ ] LSI レジスタ操作 

-- ② 一 

③ 

BIOS 管理 


共通制御情報域 

④ ユーザ側の領域 

1 1 

-1 問い合わせ悄報 


⑤ 

サウンドライブラリの領域 


デイレイド 

データ群 

ユーザ 側の領« 

⑤ 

1 

MML データ群 


① mc _ register の機能コード1によって，直接データを LSI のレジスタに設定します。 

② mc register の機能コード2によって， LSI のレジスタから直接データを読み込みま 
す。 

③ サウンド BIOS の割り込み制御によって，逐次，ディレイドデータ（指令）を読み 
出して解析し， LSI に命令を送って演奏を行ないます。また，これに伴い共通制御悄 
報域上の管理情報を逐次更新しています。これらの動作は利用者が本来関知する必 
要はありません。 

④ me inquire によって，共通制御情報域上の各チャンネルの制御情報を利用者側の領 
域に読み出します。 

⑤ meplay により MML フォーマットデータをディレイドフォーマットデータに変 
換し，サウンド BIOS に演奏を委託します。このとき，サウンド BIOS の割り込み 
処理がディレイドデータ（指令）を解析し，図 2.2 の③や④のデータ転送操作を行な 
います。 
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2.2 は音色データのデータ転送を行なう関数や機能の関係を表したものです。 

図 2.2 音色データとデータ転送関係 



① mc scalar の機能コード1によって， LSI のレジスタの一部を利用者が指定した値で 
一時的に冉き換えます。 

② mc scalar の機能コード2によって， LSI のレジスタの内容を利用者側の領域に統み 
出します。 

③ MML 上に記述されたコマンド Y によって， LSI のレジスタの一部を一時的に苒き 
換えます。これは①と同じ機能です。 

④ MML 上に記述されたコマンド @ x によって，ブロック単位で音色データを LSI の 
レジスタに設定します。 

⑤ mc _ block の機能コード1によって，利用者が作成した音色データをサウンドライブ 
ラリ内のバンクに登録します。 

⑥ me block の機能コード2によって，サウンドライブラリ内の音色データバンクを利 
用者側の領域に読み出します。 

⑦ mcrom により ROM 内の音色データをサウンドライブラリ内の音色データバン 
クに再設定しなおします 。 me initialize も使用しています。 
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MML を BNF (バッカス•ナウア記法）で表現したものを以下に示します。 


< MML > 【くコマンド鮮> ••• 】-¥0* 

<コマン KK > is - 

<音符コマンド> 丨 <エンべローブ用期コマンド> | 

<エンべローブ形状コマンド> 丨 <音量コマンド> I 
<省略轉の音長コマンド> I <音畏比率コマンド> I 
くオクターブコマンド> I <オクターブ上下コマンド> I 
<音8直接コマンド> 丨 <テンポコマンド> |<休符コマンド 
<音色コマンド> | <レジスタコマンド> | <休止コマンド> 
<移»コマンド> | <LFO 効果コマンド> | 

<音色バラメータコマンド> 丨 <演赛形®コマンド> 


<音符コマンド> 

<エンべローブ用期コマンド> 
<エンべローブ形状コマンド> 
<音量コマンド> 

<省略••の音長コマンド> 

<音長比串コマンド> 

<ォクターブコマンド> 

<ォクターブ上下コマンド> 

<音程直推コマンド> 

<テンポコマンド> 

<休符コマンド> 

<音色コマンド> 

<レジスタコマンド> 

<休止コマンド> 

<移»コマンド> 

< LFO 効果コマンド> 

<音色バラメータコマンド> 

<連符コマンド> 

<演赛形®コマンド> 

<音租> 

<學音_> 

<音長> 

<»值> 

<败字> 


:音 S 


<半音》> 


H 

S 

V 

L 

Q 

〇 

> 

K 

T 


M 

C 


Y 

§W 


<败 
<败 
<败 
<音 
<败 
<败 

I * 

<败 
<败 
• I 

<败 

<败 

[ 

<音 


: ffll 


P 


音長 


«> 


:败值 


<数值> _パ < 数值> 
<コマンド鮮> ••• 

{ | } 

I 'D* ! -E- | *P 


:資* 




ft 値: 
败字 

0- I 
5* I 


〔数値: 


3 

8 


■文字と文字の問の空白やタブは意味を持ちません。また，文字は半角文字のみで全角 
文字は許されません。 


■表記の中で使われている記号は，次のような意味を持っています。 

[ a ] a を選択します。省略してもかまいません。 

{ a } a を必らず選択します。 

a ! b a か b どちらかを必らず選択します。 
a … a を繰り返します。 
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注意： サ ウン ドライブラリの一部の関数では，データのやりとりに パヶッ ト構造体を使用 
しています。ハ。 ケッ ト構造体についてはこの章の 「 PC -9801 の ROM-BIOS インターフエ 
ース 」の節の最初に説明があるので，表の見方などはそちらを参照してください。 
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block 


機能 音色データを設定または統み出します。 

形式 # include く music . h 〉 

int mc _ block ( MC_BLOCK * blk ) : 

ブロトタイプ music.h 


解説 mc_block は，荇色データ（バラメータブロック）の設定，統み出しを行な 

います。 

パヶット内の機能コード cmmd が 1 のとき，荇色データ番号 base で指定さ 
れたサウンドライブラリ内の音色データバンクにパケット内の個々の項目 
を設定します。 

機能コードが2のとき，咅色データ番号 base で指定されたサウンドライブ 
ラリ内の音色データバンクからパケット内の個々の項目に読み込みます。 
構造体 MCINQUIRE は， music . h で次のように定義されています。 


typeder struct { 

unsigned cnar cmmd ； 
unsigned char stus; 
unsigned char base; 
unsigned char fb_alg ； 
unsigned char at_r[4 ]； 
unsigned char opr 一 msk; 
unsigned char dc r[4 ]； 
unsigned char wav_form_lfo ； 
unsigned char 88_r(4J; 
unsigned char 8ync_dly_lfo ； 
unsigned char rl_r[4]; 
unsigned int speed 一 1fo; 
unsigned char ss_l(A )； 
unsigned char p_mod_lfo 5 
unsigned char op_l[4); 
unsigned char a 一 mod_lfo; 
unsigned char keyscl[4 ]； 
unsigned char p 一 mos lfo ； 
unsigned char mult[4】； 
unsigned char resvl ； 
unsigned char detun[4] : 
unsigned char resv2 ； 
unsigned char a 一 mos lfo[4 ]； 
} MC BLOCK; 


/* 襯齟コード*/ 

/* 寅行後の状態*/ 

I * 音色データ番考〇〜81 */ 

/* フイードバック/アルゴリズム*/ 

/* アタック係数*/ 

/* オペレータマスク*/ 

/* デイケイ係败 */ 

/* LFO 波！！*/ 

I * サステイン係数*/ 

/* LFOSYNC 通 BW 間*/ 

/* リリース係败 */ 

/* LFO 効果の速度*/ 

/* サステインレベル*/ 

/* LFO 効果のビッチ変謂深さ*/ 

/* 出カレベル*/ 

I * LFO 効果の振幅変 W 深さ*/ 

I * KEY スケーリング深さ*/ 

I * LFO 効果ビッチ寳謂深さ（粗《螯） */ 
/* マルチプル*/ 

I * 予約*/ 

/* デチューン係数*/ 

/* 予約*/ 

I * LFO 効果振幅変調深さ（粗調蹩） */ 
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戻り値 


音色データの詳細はサウンドボードユーザーズマニュアルと 「FM 音源ス 
ー パーサウンド」 を参照してください。 

音色データ番号 base が異常なとき，0以外を返します。また，パケット内 
の終了状態 stus が設定されます。 


内のデータの授受 







可搬性 この関数は PC -9801 シリーズでのみ動作します。 

閲連項目 me scalar , me rom 
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mc_continue 


機能 

形式 

プロトタイプ 

解脱 

戻り値 

可搬性 

関連項目 
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演奏を再開します。 


void me continue ivoid ). 


music.h 

mc continue は ， me stop で中断されていた简所から演奏を再開します。 
ただし ， me initialize を実行したときは再開されません。 

ありません。 

この関数は PC .9801 シリーズでのみ動作します。 


me stop 
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me—ground 


機能 演奏モードを切り換えます。 

形式 int mc _ ground(int mode ) ； 

プロトタイプ music.h 

解脱 me ground li , 指定された mode により演奏モードをフォアグラウンドま 

たはバックグラウンドモードに切り換えます。引数 morfe が1のときはフォ 
アグラウンドモードを意味し，2のときはバックグラウンドを意味します。 
フォアグラウンドのときは演奏が終了するまで次の処理はを行ないません。 
現在のモードを知りたいときは me inquire を使用してください。 

戻り値 爪〇办が範囲外のときは0以外を返します。 

可搬性 この関数は PC -9801 シリーズでのみ動作します。 

閣連項目 me inquire 
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mc_initialize 

機能 サウンドライブラリの実行環境を初期化します。 

形式 int me initialize ( void ) : 

プロトタイプ music.h 

解脱 mejnitialize は，サウンドライブラリの実行環境を初期化します。他のサ 

ウンド関数を実行する前に，必らずこの関数を一度実行しなければなりま 
せん。また，この関数はサウンド拡張機能を次のように初期化します。各 
チャンネルのディレイドデータ用領域は300バイトに固定されています。 

■ SSG エンべ ローブ ： M 255, S 1 

■ SSG 音设 : V 7 

■音長 ： L 4 ( R 4) 

■音の長さの割合 ： Q 7 

■オクターブ ： 04 

■テンポ ： T 120 

■ FM チャンネル音色： 0(デフォルト音 

■音色バンク ：立上げ時の状態に設定 

■演奏モード ：フォアグランド，楽音モード 

この関数は N 88- BASIC (86) のサウンド拡張命令 PLAY ALLOC に相当 
します。 

戻り 値 サウンドボードが実装されていないときには，0以外を返します。 

可撤性 この関数は PC -9801 シリーズでのみ動作します。 
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mcJnquire 


機能 

演奏状況を調べます。 

形式 

¥ include く music . h > 


int mc _ inquire(MC INQUIRE * inq ) : 

プロトタイプ 

music.h 


解脱 mcinquire は，構造体 MCJNQUIRE 内に全チャンネルのエンプティ割 

り込み条件，未演奏データ長，カレント Key - No ., デフォルト咅長，カレ 
ントタッチ，演奏中フラグとテンポ数を返します。また，メンバ 
maxsize , minsize に全チャンネル中で®技の未演奏データ技と/6：短の未 
演奏データ長を返し，メンバ allbusy には全チャンネル中で現在演奏中か 
どうかを返します。1つでも演奏中のときは0以外を，全演奏が終了してい 
るときは0を返します。メンバ ground は現在フォアグラウンド （1) かバッ 
クグラウンド⑵であるかを示し，メンバ mode は現在の演奏モードを示し 
ています。 

怫造体 MC INQUIRE は， music . h で次のように定義されています。 


typedef struct ( 

unsigned cnar cmmd ； 
unsigned char stus; 
int unsize[6] : 

unsigned int empty(6); 
unsigned char keyno[6]; 
unsigned char length[6]; 
unsigned char touch(6); 
unsigned char busy[6 】； 
unsigned char tempo ； 
int maxsize ； 

int minsize; 

char ground; 

char mode ； 

unsigned char allbusy; 

} MC INQUIRE; 


/* 禳齟コード現在未使用*/ 

/* 実行後の状態现在未使用*/ 

I * 各チヤンネルの未演赛データ長 */ 

/* 各チヤンネルの fl り込み条件*/ 

I * 各チヤンネルのカレントキー番昜 */ 
/* 各チヤンネルのデフオルト音長*/ 

/* 各チヤンネルのカレントタッチ*/ 

I * 各チヤンネルの演赛中フラグ*/ 

/* テンポ数*/ 

/* 最長の未演赛データ長 */ 

/* 最短の未演赛データ長 */ 

/* 現在の»理モード1, 2 */ 

/* 現在の演赛 モー K 1, 2 t 3 */ 

/* 全チヤンネルの演赛状況*/ 
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戻り値 


全チヤンネルの演奏状況 allbusy と同じ値を，16ビット中の下位8ビットに 
返します。 


■バケツト内のデータの授受 


MC INQUIRE 


emmd 

X 

stus 

X 

unsize 

W 

empty 

W 

keyno 

W 

length 

W 

touch 

W 

busy 

W 

tempo 

W 

maxsize 

W 

minsize 

W 

ground 

w 

mode 

w 

allbusy 

w 


可搬性 この関数は PC -9801 シリーズでのみ動作します。 

閲連項目 me play , me ground，me mode 
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mc_mode 


機能 チャンネル 3 に対してモードを指定します。 

形式 int me mode(int fm ) \ 


ブロトタイプ music.h 


解脱 me mode は，チャンネル3(サウンドライブラリ内では CH 2) の FM 音源 

に対するモード指定です。引数/ m が1のときは楽音モード，2のときは効果 
音モード，3のときは CSM モードを意味します。現在のモードを知りたい 
ときは me inquire を使用してください。 

戻り価 fm が範囲外のときは0以外を返します。 

可搬性 この関数は PC -9801 シリーズでのみ動作します。 

閫連項目 me inquire 
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機能 


演奏を行ないます。 


形式 # include く music.h 〉 

int mc_play(MC—MML * mml ) : 

プロトタイプ music.h 

解脱 mc_play は，構造体 MC MML 内のメンバ mml に与えられた MML の指 

示にしたがって音楽を演奏します。 MML のフォーマットの詳細はサウン 
ドボードユーザーズ マニュアルを 参照してください。 MML を指定しない 
チャンネルは， NULL ポインタを設定するか，または NULL 文字列を与え 
ます。構造体 MCMML はへッダファイル music.h に下記のように定我さ 
れています。 

typedef struct { 

unsigned char cnmd ; /* 機齟コード現在未使用*/ 

unsigned char 8 tus 5 /* 寅行後の状戆現在未使用*/ 

char * mnl [6 J 5 /* MML 文字 W 配列*/ 

int err_ch 5 I * エラーチヤンネル番得*/ 

int err _ po 8 5 /* エラー位置*/ 

)MC 一 MML; 

注窓：チャンネル番号は通常 CH1 〜 CH6 で表現されますがサウンドライ 
ブラリ中では CHO 〜 CH5 で表現します。 

この関数は N88-BASIC(86) のサウンド拡張命令 PLAY に相当します。 
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戻り値 正常終了したときは0を返し，指定された MML にてエラーが発生したと 

きは0以外を返します。また，パケット内の変数 err _ ch にエラーを起こした 
チャンネル番号，変数 errpos にエラーを起こした MML 文字列中の位置 
を返します。 


■バケツ ト内のデータの授受 


MCMML 

-- 1 


cmmd 

X 

stus 

X 

mml 

R 

errch 

W 

err pos 

W 




可搬性 この関数は PC -9801 シリーズでのみ動作します。 
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mc__register 

機能 サウンド LSI 内のレジスタを操作します。 

形式 # include く music . h 〉 

void me register(MC REGISTER * reg ) : 

ブロトタイプ music.h 

解脱 mcregister は，サウンド LSI の各レジスタにデータを直接設定したり， 

読み出しを行なったりします。 

バケット内の機能コード emmd が1のとき，レジスタ#号びぎで指定され 
たレジスタに設定値 value を設定します。 

機能コード emmd が2のとき，レジスタ番号 reg で指定されたレジスタを 
I 光み込み値 value に统み込みます。 

構造体 MC REGISTER は， music . h で次のように定義されています。 

typeder struct { 

unsigned char emmd ； 
unsigned char stus; 
unsigned char reg ； 
unsigned char value 
)MC_REGISTBR; 

SSG 周波数 • SSG ノイズ，固定 ft / 可変音 M , エンべローブ 周期， エンべ 
ローブ形状等の機能の操作は，この関数によって行ないます。 

この関数は N 88 - BASIC (86) のサウンド拡張命令 VOICE REG に相当し 
ます。 


/* 檐籣 コード*/ 

/* 実行後の 状態*/ 

I * レジスタ 番溽 0 x 00 〜 OxFF */ 
/* 設定 値/嫌 込 値*/ 
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戻り値 ありません。 


■バケツト内のデータの授受 


MCREGISTER 

01 

02 

cmmd 

R 

R 

stus 

X 

X 

reg 

R 

R 

value 

R 

W 


可撤性 この関数は PC -9801 シリーズでのみ動作します。 
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mc_rom 


機能 

形式 

ブロトタイプ 

解脱 

戻り価 

可搬性 

M 連項目 
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咅色データバンクを再設定します。 
int mc_rom(int base, int n ) : 
music.h 

me 一 rom は，引数ん we で指されるサウンド BIOS - ROM 内の音色データバ 
ンクから引数”個分を，該当するサウンドライブラリ内の音色データバン 
クに再設定します。 

サウンド BIOS - ROM が存在しないときは〇以外を返します。ゐ⑽とれの 
関係が不正なときは0以外を返します。 

この W 1 数は PC -9801 シリーズでのみ動作します。 

me block 
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mc_scalar 


機能 チャンネルの各パラメータのデータの設定/読み出しを行ないます。 

形式 # include く music . h 〉 

int me scalar(MC SCALAR * sea ) \ 

プロトタイプ music.h 


解脱 


me scalar は，サウンド LSI の各チャンネルの各バラメ ータにデータ を単 
体で設定したり，1充み出しを行なったりします。 

バケット内の機能コード emmd が1のとき，チャンネル番号 eh とパラメー 
夕番号 param で指定された機能/、•ラメータに設定値 value を設定します。 
機能コード emmd が2のとき，チャンネル番号 eh とパラメータ番号 
param で指定された機能パラメータを洸み込み値 value に読み込みます。 
構造体 MC SCALAR は， music . h で次のように定義されています。 


typedef struct { 

unsigned char emmd ； 
unsigned char 8tus ； 
unsigned char eh; 
unsigned char param; 
unsigned int value; 
} MC SCALAR ; 


/* 檐齟 コード*/ 

/* 実行後の状®*/ 

I * チヤンネル 番溽 CHO 〜 CH5 */ 
/* バラメータ 番号 〇〜 49 */ 

/* K 定值 /M 込値*/ 


戻り値 チャンネル番号 eh とパラメータ番号 param が異常なとき，0以外を返し 

ます。また，パケット内の終了状態 stus が設定されます。 
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■バケツト内のデータの授受 


MC—SCALAR 

01 

02 

emmd 

R 

R 

stus 

W 

W 

eh 

R 

R 

param 

R 

R 

value 

R 

W 


可撤性 この関数は PC -9801 シリーズでのみ動作します。 

関連項目 me block 
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mc_stop 


機能 

演奏を中断します。 

形式 

void me stop ( voia ) : 


プロトタイプ music.h 

解説 mc_stop は，全チャンネルの演奏を中断します 0 演奏中にユーザブログラ 

ムが終了するときは，通常この関数を呼び出しますが，実行しなくても演 
奏は自動的に中止されます。これは演奏中に CTRL - C を押した場合でも有 
効です。逆に演奏したままで利用者のブログラムを常駐終了させたいとき 
は，次に示す変数をブログラムで外部定我してください。 

int mc_nonstop _ 1; 

通常，ユーザブログラムで最後まで演奏するときには， me inquire によつ 
て演奏が全チャンネルが終了したかチヱックしてから me stop を実行し 
ます。 

注意： ブログラムを強制終了させるには， CTRL-C を押す方法と STOP キ 
一を押す方法があります。システムがハードディスクを備えている場合に 
STOP キーで強制終了させると，システムが暴走することがあるので注意 
してください。 

戻り値 ありません。 

可搬性 この関数は PC-9801 シリーズでのみ動作します。 

閣連項目 me continue 
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日本語処理ライブラリ 


TurboC は，日本語を正しく処理することができるようになっています。もう少し具体 
的に言えば，文字列内に含まれる全角文字 （2 バイトコード）を，全角文字として正しく認 
織し，処理するということです。また，全角文字と ANK 文字の判別や，全角文字として 
正しいコードかどうかの判定，全角文字から半角文字へ（あるいはその逆）の変換などを 
行なうライブラリルーチンも用意されています。 

この章では • ブログラムで漢字を使用する際の注意点（はんの少しですが）を肢初に述 
ベ，そのあと日本語処理ライブラリ関数のリ ファレ ンス夯のせてあります。 
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漢字オプション 


全角文字の第 1 バイトは， 0 x 81 〜 0 x 9 F ， および OxEO 〜 OxFC の範囲になります。この範 
囲のコードは，モードによってはグラフ ィッ ク文字として使用されます。 

全角文字の第 2 バイトの範囲は， 0 x 40 〜 0 x 7 E , および 0 x 80 〜 OxFC です。この範囲のコー 

ドは， ANK の英字と記号の一部，半角のカタカナ，およびグラフ ィッ ク文字と重なってい 
ます。 

C で全角文字を扱う際に問題になるのは，この第 2 バイト目が， ¥ x 5 C ， （円記号）の場合で 
す。円記せは， C の文字列では通常エスケープシーケンスとして使用され てい るので， その 
ままでは文字化けなどの思わぬ結果になってしまいます。 

T urbo C には，文字列内の円記号のコードをエスケープシーケンスとしてではなくそ 
のまま文字列の-部として扱い•また全角文字は2バイト単位で正しく扱うようにするため 
のすブション（漢字オプション）が用意されています。デフォルトでは漢字オプションは 
オンになっており，文字列の中の 0 x 81 〜 0 x 9 F およ t /0 xE 0^0 xFC のコードは全角文字の 
第1バイトであると認識され，その次の1バイトは全角文字の第2バイト とみな されます。 

漢字オブションをオフにすると，その範囲のコードは1バイト単位でグラフ ィッ ク文字と 
して扱われることになります。 

潢字オブンョンは， TC (統合環境版）では， Options/Compiler メニューの ， Code genera - 
ticm/Kanji strings です 。 TCC (コマンドライン版）ではづになっています。グラフ ィッ 

ク文字を使用する場合には，メニュ-オブションをオフにするか， TCC であればコマンド 
ライン（または TURBOC . CFG の中）で- J - を指定して〈ださぃ。 
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btom 


機能 

形式 

プロトタイプ 

解脱 

戻り値 

可搬性 
閧連項目 
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文字列の先頭から nbyte までに存在する文字数を調べます。 


unsigned int btom (char * string , unsigned int n ). 
jstring.h 


btom は，引数が/で指定された文字列の先頭から n バイトまでに存在 
する文字数を調べます。全角文字も1文字として数えます。 

指定した n バイト内にヌル文字が現われた場合は，そのヌル文字の直前ま 
での文字数を返します。さらにこのヌル文字が漢字2バイト目にあたる場合 
は，その前の漢字第1バイト目もヌル文字とみなして文字数には含みませ 
ん。 また n バイ ト目が漢字1バイトである場合もその直前までの文字数を 
返します。 


btom は，指定された範囲の文字数を返します。 n に0を指定すると0が返さ 
れます。 

MS - DOS に特有の関数です。 


mtob 


第 2 章 Turbo C ライブラリ 



chkctype 


機能 文字タイプを調べます。 

形式 # include < jctype . h > 

mt chktype(char c 9 int type ) : 


ブロトタイブ jctype.h 


解脱 


chkctype は，文字 c のタイプを調べます。引数ひ％によって，タイプを判 
定する基準を指定します。 

の値と戻り値の関係は，次のようになります 


type 

戻り値 

(価） 

意味 

1以外 

CTANK 

(0) 

ANK 文字 

1以外 

CT 一 KJ 1 

(1) 

漢字第1バイト 

1 

CTKJ 2 

(2) 

漢字第2バイト 

1 

CTJLGL 

(-1) 

無効なタイプ 


無効なタイブとは，漢字の第2パイトが iskanji 2 でないか， c がヌル文字で 
ある場合を意味します。 

可搬性 MS - DOS に特有の関数です。 

W 連項目 nthctype 


日本語処理ライプラリ 
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hantozen 


機能 

形式 

プロトタイプ 

解脱 

戻り値 

可搬性 

関連項目 


半角文字を全角文字に変換します。 

unsigned short hantozen (unsigned short c ) : 

jctype.h 

hantozen は，半角文字 c を全角に変換します。ただし変換が行なわれるの 
は，半角文字が 0 x 20 〜 0 x 7 e の範囲に限られます。 

hantozen は，変換が正し〈行なわれれば，変換後の文字コードを返しま 
す。変換できなかった場合には， c をそのまま返します。 

MS - DOS に特有の関数です。 

zentohan 


712 


第2章 Turbo C ライブラリ 



isalkana 


機能 英文字またはカナ文字かどうかを判定します。 

形式 # include < jctype . h > 

int isalkana (mt c ) : 

ブロトタイプ jctype.h 

解脱 isalkana マクロは， c が英文字またはカナ文字であるかどうかを判定しま 

す 0 (isalpha + iskmoji ) 

戻り値 条件を満たせば0以外の值を，そうでなければ0を返します。 

可搬性 MS - DOS に特有のマクロです。 

isainmkana 

機能 英数字またはカナ文字かどうかを判定します。 

形式 # include く jctype . h 〉 

int isainmkana (int c ) : 

プロトタイプ jctype.h 

解脱 isainmkana マクロは， c が英数字またはカナ文字であるかどうかを判定 

します 。 （isalnum + iskmoji ) 

戻り値 条件を満たせば0以外の値を，そうでなければ0を返します。 

可撤性 MS - DOS に特有のマクロです。 
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isgrkana 


機能 スペース以外の半角文字かどうかを判定します。 

形式 # include < jctype . h > 

int isgrkana unt c ) : 

プロトタイプ jctype.h 

解脱 isgrkana マクロは， c がスペース以外の半角文字かどうかを判定します。 

戻り値 条件を満たせば0以外の値を，そうでなければ0を返します。 

可搬性 MS - DOS に特有のマクロです。 

iskana 

機能 半角のカナコードかどうかを判定します。 

形式 # include く jctype . h 〉 

int iskana (int c ) : 

プロトタイプ jctype.h 

解脱 iskana マクロは， c が半角のカナコードかどうかを判定します。 

(OxAl ^ c g OxDF ) 

戻り 値 条件を満たせば0以外の値を，そうでなければ0を返します。 

可搬性 MS - DOS に特有のマクロです。 
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iskanji 

機能 

漢字第1バイトかどうかを判定します。 

形式 

# include < jctype . h > 

int iskanji (int c ) : 

ブロトタイプ 

jctype.h 

解脱 

iskanji マクロは，（:が漢字第 1 バイトかどうかを判定します。 

(0 x 81 ^ c g 0 x 9 F または OxEO ^ c ^ OxFC ) 

戻り 値 

条件を満たせば0以外の値を，そうでなければ0を返します。 

可撤性 

MS - DOS に特有のマクロです。 

iskanji2 

機能 

漢字第2バイトかどうかを判定します。 

形式 

# include く jctype . h 〉 

int iskanji 2 (int c ) : 

プロトタイプ 

jctype.h 

解脱 

iskaiiji 2 マクロは， c が漢字第 2 バイトかどうかを判定します。 

(0 x 40 ^ c ^ 0 x 7 E または 0 x 80 ^ c ^ OxFC ) 

戻り 値 

条件を満たせば0以外の値を，そうでなければ0を返します。 

可撤性 

MS - DOS に特有のマクロです。 
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iskmoji 


機能 半角のカナ文字かどうかを判定します。 

形式 # include < jctype . h > 

mt iskmoji unt c ) : 

プロトタイプ jctype.h 

解脱 iskmoji マクロは， c が半角カナ文字かどうかを判定します。 

(0 xA 6 ^ c ^ OxDF ) 

戻り値 条件を满たせば0以外の値を，そうでなければ0を返します。 

可搬性 MS-DOS に 特有の マクロ です。 

iskpun 

機能 半角のカナ句読点かどうか判定します。 

形式 # include く jctype . h 〉 

int iskpun (int c )； 

プロトタイプ jctype.h 

解脱 iskpun マクロは， c がカナ句読点かどうかを判定します。 

(OxAl ^ c ^ 0 xA 5) 

戻り値 条件を満たせば0以外の値を，そうでなければ0を返します。 

可撤性 MS-DOS に 特有の マクロ です。 
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ispnkana 


機能 英句読点またはカナ句読点であるかどうかを判定します。 

形式 # include く jctype . h 〉 

int ispnkana (int c ), 

プロトタイプ jctype.h 

解脱 ispnkana マクロは， c が英句統点またはカナ句統点であるかどうかを判定 

します 0 (ispunct + iskpun ) 

戻り値 条件を满たせば0以外の値を，そうでなければ0を返します。 

可搬性 MS - DOS に特有のマクロです。 

isprkana 

機能 半角文字かどうかを判定します。 

形式 # include く jctype . h 〉 

int isprkana (int c ). 

ブロトタイプ jctype.h 

解脱 isprkana マクロは， c が半角文字かどうかを判定します。 

(ispnnt + iskana ) 

戻り値 条件を満たせば0以外の値を，そうでなければ0を返します。 

可撤性 MS - DOS に特有のマクロです。 
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jasctime 


機能 asctime の日本語対芯版です 0 

形式 # include < time . h > 

char 木 jasctime (const struct tm 木 tm ) \ 

プロトタイプ time.h 

解脱 jasctime は， asctime の日本語対応版で，変換後の文字列は次の形式にな 

ります。 

1988年09月23日（金） 07 sl 5:06¥ n ¥0 

詳細については asctime を参照してください。 

戻り値 変換後の文字列へのボインタを返します。 

可撤性 MS - DOS に特有の関数です。 

閬連項目 asctime , ctime , jctime 
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jctime 


機能 

形式 

プロトタイプ 

解脱 


戻り値 
可撤性 

関連項目 


ctime の日本語対応版です。 

# include < time . h > 

char * jctimeiconst time t * clock ) \ 
time.h 

jctime は， ctime の日本語対応版で，変換後の文字列は次の形式になりま 
す。 

1988年09月23日（金） 07:15:06¥ n ¥0 

詳細については ctime を参照してください。 

変換後の文字列へのポインタを返します0 
MS - DOS に特有の関数です。 

asctime ， ctime , jascume 
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jisalpha 

機能 全角英文字かどうかを判定します。 

形式 int jisalpha (unsigned short c ) : 

ブロトタイプ jctype.h 

解脱 jisalpha (i, c が全角英文字かどうかを判定します。 

(0 x 8260 ^ c ^ 0 x 8279 または 0 x 8281 ^ c ^ 0 x 829 A ) 

戻り値 条件を満たせば0以外の値を，そうでなければ0を返します。 

可搬性 MS-DOS に特有の関数です。 

jisdigit 

機能 全角数字かどうかを判定します。 

形式 int jisdigit (unsigned short c ) : 

ブロトタイプ jctype.h 

解脱 jisdigit は，. c が全角数字かどうかを判定します。 

(0 x 824 F ^ c ^ 0 x 8258) 

戻り値 条件を満たせば0以外の値を，そうでなければ0を返します。 

可搬性 MS-DOS に特有の関数です。 
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jishira 


機能 

全角ひらがなかどうかを判定します。 

形式 

int jishira (unsigned short c ) : 

プロトタイプ 

jctype.h 

解脱 

jishira li , c が全角ひらがなかどうかを判定します。 
(0 x 829 F ^ c ^ 0 x 82 Fl ) 

戻り値 

粂件を満たせば0以外の値を，そうでなければ0を返します 

可撤性 

MS-DOS に特有の関数です。 

間連項目 

jiskana，jiskata 


日本 R 処理ライブラリ 


721 


jiskana 


機能 全角カタカナかどうかを判定します。 

形式 int jiskana (unsigned short c ) : 

ブロトタイプ jctype.h 

解脱 jiskana は， c が全角カタカナかどうかを判定します。 

(0x8340 ^ c ^ 8396) 

戻り値 粂件を満たせば0以外の値を，そうでなければ0を返します。 

可搬性 MS - DOS に特有の関数です。 

関連項目 jishira , jiskata 
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jiskata 


機能 

全角カタカナかどうかを判定します。 

形式 

int jiskata (unsigned short c )； 

ブ□トタイプ 

jctype.h 

解脱 

jiskata は， c が全角カタカナかどうかを判定します。 
(0 x 8340 ^ c g 8396) 

この関数は， jiskana とまったく同じです。 

戻り値 

条件を満たせば0以外の値を，そうでなければ0を返します。 

可撤性 

MS - DOS に特有の関数です。 

間連項目 

jishira , jiskana 
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jiskigou 

機能 全角句読点かどうかを判定します。 

形式 int jiskigou (unsigned short c ) : 

ブロトタイブ jctype.h 

解脱 jiskigou は， c が全角句読点かどうかを判定します。 

(0 x 8141 ^ c g 0 x 81 AC ) 

戻り値 条件を満たせば0以外の値を，そうでなければ〇を返します。 

可搬性 MS - DOS に特有の関数です。 

jislO 

機能 シフト JIS コード中の澳字以外の文字かどうかを判定します。 

形式 int jislO (unsigned short c ) : 

プロトタイブ jctype.h 

解脱 jislO は， c がシフト JIS コードの中の漢字以外かどうかを判定します。 

(0 x 8140 S c g 0 x 889 E ) 

戻り値 条件を満たせば0以外の値を，そうでなければ〇を返します。 

可撤性 MS - DOS に特有の関数です。 

関連項目 jisll , iisl 2 
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jisll 


機能 

JIS 第1水準漢字かどうかを判定します。 

形式 

int jisll (unsigned short c ) : 

プロトタイプ 

jctype.h 

解脱 

jisll は， c が JIS 第 1 水準の漢字かどうかを判定します。 
(0 x 889 F ^ ^ 0 x 9872) 

戻り値 

条件を满たせば0以外の値を，そうでなければ0を返します。 

可搬性 

MS - DOS に特有の関数です。 

関連項目 

jislO , ji 8 l 2 
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jisl2 


機能 JIS 第 2 水準漢字かどうかを判定します。 

形式 int jisl 2 (unsigned short c ) : 

プロトタイプ jctype.h 

解脱 jisl 2 は， c が JIS 第 2 水準の潢字かどうかを判定します。 

(0 x 989 F ^ c ^ 0 xEA 9 E ) 

戻り値 条件を満たせば0以外の値を，そうでなければ〇を返します。 

可撤性 MS - DOS に特有の閲数です。 

閬連項目 jislO , jisll 
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jislower 

機能 

全角英小文字かどうかを判定します。 

形式 

int jisiower (unsigned short c ) : 

ブロトタイブ 

jctype.h 

解脱 

jislower li , c が全角英小文字かどうかを判定します。 

(0 x 8281 ^ c ^ 0 x 829 A ) 

戻り値 

条件を満たせば0以外の値を，そうでなければ0を返します。 

可撤性 

MS-DOS に特有の関数です。 

関連項目 

jisupper 


jisspace 


機能 

全角スペースかどうかを判定します。 

形式 

int jisspace (unsigned short c ) : 

プロトタイプ 

jctype.n 

解脱 

jisspace は， c が全角スベースかどうかを判定します。 

(c = 0 x 8140) 

戻り値 

条件を満たせば0以外の値を，そうでなければ0を返します。 

可撤性 

MS-DOS に特有の関数です。 
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jistojms 

機能 JIS コー ドをシフト JIS コー ドに変換します0 

形式 unsigned short int jistojms (unsigned short int ch ) \ 

プロトタイプ jctype.h 

解脱 jistojms は， JIS コード c / z をシフト JIS コードに変換します。 

の上位バイトに JIS コードの第1バイト， M の下位バイトに JIS コード 
の第2バイトが入っていなければなりません。 

戻り値 cA が JIS コードとして適切な侦であれば，対応するシフト JIS コードを返 

します。 cA が適切でない場合は0を返します。 

可搬性 MS - DOS に特有の関数です。 

関連項目 jmstojis 
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jisupper 


檐能 

全角英大文字かどうかを判定します。 

形式 

int jisupper (unsigned short c ) : 

ブロトタイプ 

jctype.h 

解脱 

jisupper は， c が全角英大文字かどうかを判定します。 

(0 x 8260 ^ c ^ 0 x 8279) 

戻り値 

条件を満たせば0以外の値を，そうでなければ〇を返します。 

可搬性 

MS-DOS に特有の関数です。 

関連項目 

jislower 


jiszen 


機能 

全角文字かどうかを判定します。 


形式 

int jiszen (unsigned short c ) : 


プロトタイプ 

jctype.h 


解脱 

jiszen は， c が全角文字かどうかを判定します。 

(0 x 8140 ^ c g OxEFFC ) 


戻り値 

条件を満たせば0以外の値を，そうでなければ0を返します。 


可搬性 

MS-DOS に持有の関数です。 
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jmstojis 


機能 シフト JIS コードを JIS コードに変換します。 

形式 unsigned short int jmstojis(unsigned short int ch ) \ 


ブロトタイプ jctype.h 


解脱 jmstojis li , シフト JIS コード cA を JIS コードに変換します 0 

cA の上位バイトにシフト JIS コードの第1バイト， ch の下位バイ トにシフ 
卜 JIS コードの第2バイトが人っていなければなりません。 

戻り値 cA がシフト JIS コードとして適切な値であれば，対応する JIS コードを返 

します。 cA が適切でない場合は0を返します。 

可搬性 MS - DOS に特有の関数です。 


関連項目 
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jstradv 


機能 文字列ポインタを移動させます。 

形式 char * jstraav (unsigned char ★ s t unsigned int n ) : 

ブロトタイプ jstring.h 

解脱 jstradv は， s が指す文字列のボインタを n 文字だけ移動し，そのポインタ 

を返します。全角文字も1文字として数えます。 

指定した文字数内にヌル文字が現われた場合は，そのヌル文字を示すボイ 
ンタを返します。さらにヌル文字が漢字2バイト目にあたる場合は，その前 
の涣字第1バイト目もヌル文字とみなし，第1バイト目を示すボインタを返 
します。 

戻り値 が1以上であればポインタを返し，0の場合 5 のポインタを返します0 

可撤性 MS - DOS に特有の関数です。 
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jstrchr 


機能 

形式 

プロトタイプ 

解脱 

戻り値 

可撤性 

関連項目 


732 


文字列中の指定文字の位 S を調べます。 

char 本 jstrchr (char * s t unsigned short c ) : 

jstring.h 

jstrchr は， strchr の漢字対応版で，文字列 c で指定された文字を調べ, 
(:が現われた位置のポインタを返します。 

c に全角文字を指定するときは，上位8ビットに漢字第1バイト，下位8ビッ 
卜に第2バイトが人ります。半角文字のときは，下位8ビットに値が入り， 
上位8ビットは〇が入ります。 

文字列中で現われた c のポインタを返し，見つからない場合は NULL ポ 
インタを返します。 

MS-DOS に特有の関数です。 


strchr 
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jstrcmp 


機能 文字列を比較します。 

形式 int jstrcmp (char * sl 9 char + s 2) 

プロトタイプ jstring.h 

解脱 jstrcmp は， strcmp の漢字対応版で，全角文字も1文字として数えます。 

文字列を比較する際文字の大小関係は，次に指定する順番になります。 

ANK くカナく漢字 

戻り値 strcmp を参照してください。 

可搬性 MS - DOS に特有の関数です。 

関連項目 strcmp 


日本語処理ライブラリ 


733 


jstrlen 


捩能 文字列の文字数を調べます。 

形式 unsigned int jstrlen (char * s ) : 

プロトタイプ jstring.h 

解脱 jstrlen は，引数 J が指す文字列の文字数を返します。漢字も1文字として数 

えます。ヌル文字は，文字数に含まれません。また，ヌル文字が漢字2バイ 
卜目にあたる場合はその前の澳字第1バイト目もヌル文字とみなし，文字数 
には含めません。 

戻り値 s の文字数を返します。 

可搬性 MS - DOS に特有の関数です。 

閲連項目 strlen 
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jstrmatch 


機能 strpbrk の漢字対応版です。 

形式 char * jstrmatch (char * sl t char * s2 ) : 

プロトタイプ jstring.h 

解脱 jstrmatch は， strpbrk の漢字対応版です。引数 W ともに漢字を使用 

することができます。 

戻り価 W の中で, W の文字列内に含まれる文字のどれかが最初に現われた位 SSE を 

指すポインタを返します。一致する文字がない場合には， NULL ポインタ 
を返します。 

可搬性 MS-DOS に特有の関数です。 

関連項目 strpbrk 
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jstrncat 


機能 strncat の漢字対応版です。 

形式 char * jstrncat (char * s J t char * s2 t unsigned int n) \ 

ブロトタイプ jstring.h 

解脱 jstrncat は， strncat の漢字対応版で，漢字を1文字として数えることを除 

いて，まったく同じ処理を行ないます。漢字の第2バイト目がヌル文字であ 
れば，その前の第1バイト目もヌル文字とみなされます。 

戻り値 strncat を参照してください 0 

可撤性 MS - DOS に特有の関数です。 

間連項目 strncat 
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jstrncmp 


機能 

形式 

プロトタイプ 

解脱 


戻り価 
可撤性 

関連項目 


strncmp の漢字対芯版です。 


char 本 istmcmplchar 木 s/，char * sz y unsigned mt «). 


jstring.h 


jstrncmp は， strncmp の漢字対応版で，漢字を 1 文字として数える他は同 
じ処理をします。漢字の第2バイト目がヌル文字であれば，その前の第1バ 
イト目もヌル文字とみなされます。文字列を比較する際，文字の大小関係 
は以下に指定する順番になります。 

ANK 文字 < カナ文字 < 潢字 
strncmp を参照してください。 

MS - DOS に特有の関数です。 


strncmp 
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jstrncpy 

機能 strncpy の漢字対応版です 0 

形式 char * jstrncpy (char * sJ 9 char * s 2 , unsigned int n ) : 

ブロトタイプ jstring.h 

解脱 jstrncpy は， strncpy の潢字対応版で，漢字を1文字として数える他は同じ 

処理をします。漢字の第2バイト目がヌル文字であれば，その前の第1バイ 
卜目もヌル文字とみなされます。 

戻り値 strncpy を参照してください。 

可撤性 MS - DOS に特有の関数です。 

関連項目 strncpy 
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jstrrchr 


機能 strrchr の漢字対応版です。 

形式 char 本 jstrrchr (char 木 5, unsigned int c ) : 

ブロトタイプ jstring.h 

解脱 jstrrchr は， strrchr の漢字対応版で，文字列 J で指定された文字列を凋べ 

て，（:が最後に現われた位逋を指すポインタを返します。 c に全角文字を指 
定するときは，下位8ビットに漢字第1バイト，下位8ビットに第2バイトが 
人り ます。半角文字のときは，下位8ビットに値が 人り， 上位8ビットは〇が 
入り ます。 

戻り価 文字列中で骹後に現われたへのボインタを返し，見つからない場合は 

NULL ポインタを返します。 

可撤性 MS - DOS に特有の関数です。 

間連項目 strrchr 
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jstrrev 

機能 strrev の漢字対応版です〇 

形式 char * jstrrchr(char * s ) : 

ブロトタイプ jstring.h 

解脱 jstrrchr は， strrev の漢字対応版で，文字列 J に全角文字が使えます。 

戻り値 strrev を参照してください 0 

可搬性 MS - DOS に特有の関数です。 

間連項目 strrev 
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jstrskip 


檐能 指定文字列内に検索文字列に含まれない文字があるか調べます。 

形式 char * jstrskip (char * sl t char * s 2 ) 


ブロトタイプ jstring.h 


形式 jstrskip は，文字列内に，文字列 W 中に含まれていない文字があった場 

合，その文字を指すポインタを返します。引数 5 /, W ともに全角文字を使 
用できます。 W の文字列内にヌル文字があれば，そのヌル文字を指すボイ 
ンタを返します。 

戻り値 W の中で， d に含まれない文字が現われた位逋を示すポインタを返しま 

す。 

可搬性 MS - DOS に特有の関数です。 
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jstrstr 


機能 strstr の漢字対応版です。 

形式 char * jstrstr (char + s/ t char + s2) 

プロトタイプ jstring.h 

形式 jstrstr は， strstr の漢字対応版で，引数 W と W に全角文字が使えます。 

戻り値 strstr を参照してください。 

可搬性 MS - DOS に特苻の関数です。 

関連項目 strstr 

jstrtok 

機能 strtok の漢字対応版です。 

形式 char * jstrtok (char * sl t char + s 2) : 

プロトタイプ jstring.h 

解脱 jstrtok は， strtok の漢字対応版で引数 s /， W に全角文字が使えます。 

戻り値 strtok を参照してください。 

可搬性 MS - DOS に特有の関数です。 

関連項目 strtok 
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jtohira 


全角カタカナを全角ひらがなに変換します。 


機能 

形式 

プロトタイプ 

解脱 

戻り値 

可搬性 

関連項目 


unsigned short jtohira ^unsigned short c) : 
jctype.h 

jtohira は，全角カタカナを全角ひらがなに変換します。 
c には全角文字コードを指定することができます。 

変換が正しく行なわれれば変換された文字コードを返します。変換できな 
いときには， c の値をそのまま返します。 

MS - DOS に特有の関数です。 

jtokana , jtokata 
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jtokana 

機能 全角ひらがなを全角カタカナに変換します。 

形式 unsigned short jtokana (unsigned short c ) : 

プロトタイプ jctype.h 

解脱 jtokana は，全角ひらがなを全角カタカナに変換します。 

c には全角文字コードを指定することができます。 

戻り値 変換が正しく行なわれれば，変換された文字コードを返します。変換でき 

ないときには， c の値をそのまま返します。 

可搬性 MS - DOS に特有の関数です。 

間連項目 jtohira , jtokata 
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jtokata 


機能 全角ひらがなを全角カタカナに変換します。 

形式 unsigned short jtokata (unsigned short c ) : 

プロトタイプ jctype.h 

解脱 jtokana は，全角ひらがなを全角カタカナに変換します。 

c には全角文字コードを指定することができます。 

この関数は， jtokana とまったく同じです。 

戻り値 変換が正しく行なわれれば，変換された文字コードを返します。変換でき 

ないときには， c の値をそのまま返します。 

可搬性 MS - DOS に特有の関数です。 

間連項目 jtohira , jtokana 


日本語処理ライブラリ 
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jtolower 


機能 

形式 

プロトタイプ 

解脱 

戻り偭 

可撤性 

M 連項目 


全角英大文字を全角英小文字に変換します。 
unsigned short jtolower (unsigned short c ) : 
jctype.h 

jtolower は，全角英大文字を全角英小文字に変換します。 
c には全角文字コードを与えます。 

変換が正しく行なわれれば，変換された文字コードを返します。変換でき 
ないときには c の値がそのまま返ります。 

MS - DOS に特有の関数です。 

jtoupper , tolower 
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jtoupper 


機能 全角英小文字を全角荚大文字に変換します。 

形式 unsigned short jtoupper (unsigned short c) : 

プロトタイプ jctype.h 

解脱 jtoupper は，全角英小文字を全角英大文字に変換します。 

c には全角文字コードを与えます。 

戻り値 変換が正しく行なわれれば，変換された文字コードを返します。変換でき 

ないときには c の値がそのまま返ります。 

可搬性 MS-DOS に特有の閲数です。 

関連項目 jtolower , toupper 


日本語処理ライブラリ 


747 




mtob 


機能 文字列の先頭から nmoji までに存在するバイト数を調べます。 

形式 unsigned int mtob (char + string , int nmoji ) \ 

プロトタイプ jstring.h 

解脱 mtob は，引数灯 r /叹が指す文字列の先頭から/個の文字が何バイト 

を占めるかを調べます。全角文字は2バイトとして数えます。 

指定した文字数以内にヌル文字が現われた場合は，そのヌル文字の直前ま 
でのバイト数を返します。さらにヌル文字が漢字の第2バイト目にあたる場 
合は，その直前の澳字第1バイト目もヌル文字とみなしてバイト数には含め 
ません。 

戻り 値 ” mq// が 1 以上であればバイト数を返し， 0 の場合は 0 を返します。 

可撤性 MS - DOS に特有の閲数です。 

関連項目 btom 
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nthctype 


檄能 文字列内の nbyte の位 S にある文字タイプを調べます。 

形式 # include <jctype.h> 

unsigned int nthctype (char * string ， unsigned int nbyte ) : 

プロトタイプ jctype.h 

解脱 nthctype は，引数が r /> ig 文字列内の M パ e (/ i バイト目）の位逋にある文 

字タイプを調べます。文字列の先頭を指定する際は，/2知纪は0になりま 
す。 

戻り値 文字タイプを判定して文字の«性により以下の値を返します。 


戻り値 

値 

意味 

CT ANK 

0 

ANK 文字 

CT _ KJ 1 

1 

漢字の第1バイト 

CT _ KJ 2 

2 

漢字の第2バイト 

CT _ILGL 

-1 

無効なタイブ 


無効なタイプとは，漢字の第2バイトが iskanji 2 でない場合を意味します。 
可撤性 MS - DOS に特有の関数です。 


日本語処理ライブラリ 
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zentohan 


機能 全角文字を半角文字に変換します。 

形式 unsigned short zentohan (unsigend short c ) : 

ブロトタイプ jctype.h 

解脱 zentohan は，全角文字 c を半角に変換します。変換が行なわれるのは，半 

角文字が 0 x 20 〜 0 x 7 e の範囲に限られます。 

戻り値 zentohan は，変換が正しく行なわれれば，変換後の文字コードを返しま 

す。変換できなかった場合には， r をそのまま返します。 

可搬性 MS - DOS に特有の関数です。 

関連項目 hantozen 
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付録 A 

コンパイラ エラー メ ッセージ 

Turbo C のコンバイル診断メッセージは，致命的なエラー （Fatal error ), エラー 
( Error ), 膂告 （ Warning ) の3つのクラスに分類されます。 

致命的なエラーが出ることはまれで， コン バイラ内部でのエラーを示す場合がほとんど 
です。致命的なエラーが検出されると，コンパイルはただちに中止されます。このような 
場合は，適当な処 3 K をしてから，もう一度コンパイルを行なってください0 

エラーは，ブログラムの怫文の誤り，ディスクエラーやメモリアクセスエラー，コマン 
ドラインの誤りを指摘するものです。コンハ•イラは现在行なっているフェーズが終わった 
段階で停止します。コンバイルの各フェーズ（前処理，解析，敢適化，コード生成）では， 
可能な限り多くのエラーが検出されます。 

警告が検出されても， コン ハ•イルは中止されません。問題はあるけれども，文法的には 
問違っていない場合に，膂告メッセージが出力されます。また，ブログラム中にマシンに 
依存しそうな部分を見つけた場合にも聱告メッセージを出力します。 

コンパイラは，メッセージの 先頭に エラーのクラス （Fatal error , Error ， Warning ) 

を表示し，次にェラーを検出したファイルの名前と行番号，股後にメッセージそのものを 
表示します。 

以下では，各クラスごとにアルファベット順にメッセージを示し，考えられる原因と対 
策もあわせて示します。なお，このリスト内のメッセージの中の’ XXXXXXXX •は，実際 
のメッセージではソースコードで使われている識別名やファイル名に: S き換えられます0 

エラーメッセージの行番号については注意しなければならないことがあります。 C では， 
1行の中に文をどのように辦くかについては制限がないので，実質的なェラーの原因は，指 
摘された行番号より前にある場合がしばしばあります。以下のリストでも，実質的な原因 
よりも後で検出されがちなメッセージについては，なるべくそれを指摘するようにしてい 
ます。 
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_ 致命的なエラー （ Fatal ) _ 

Bad call of in-line function 

マクロ定義からインライン関数を取り出して使用していますが，正しく呼び出してい 
ません。インライン関数は，2つの連続した下線し _) で始まりかつ終わっているもの 
で1% 

Irreduciole expression tree 

これはコンパイラ自身のエラーを表わすものです。ソースファイルの指摘された行に, 
コード生成のフェーズで，コードを作り出すことができない式が存在します。その式 
になんらかの原因が考えられる場合は，その式は取り除くべきです。このエラーが出 
た場合は， MSA カスタマーサボートセンターに連絡してください。 

Register allocation failure 

これはコンパイラ自身のエラーを表わすものです。 ソースファ イルの指摘された行に, 
コード生成のフヱーズで，コードを作り出すことができない式が存在します。その式 
になんらかの原因が考えられる場合は，式を単純なものにしてください。それでもう 
まくいかない場合は，その式は取り除くべきです。このエラーが出た場合は， MSA 力 
スタ マーサ ポートセンターに速絡してください„ 
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ェラ- 


# operator not followed by macro argument name 

マクロ定莪において，#はマクロ引数を文字列にすることを指示するために使うことが 
できます。#の後にはマクロ引数名が統かなければなりません。 

’XXXXXXXX’ not an argument 

ソース ファ イルの中で，指摘された識別名が関数の引数として宣言されていますが， 
関数引数リストにその識別名がありません。 

Ambiguous symbol ’XXXXXXXX* 

檐造体のフィールド名が，複数の構造体の中で，異なるオフセット，あるいは異なる 
型，またその両方で使われています。そのフィールドを参照するために使われた変数 
または式が，そのフィールドを含む構造体を示していません。搆造体を正しい型にキ 
ャストするか，フィールド名が問違っているのであれば正しいものに修正してくださ 


Argument # missing： name 

関数の定莪に使用された関数ブロトタイブにおいて，引数名が省略されています。関 
数をブ ロト タイプで定義する場合，ブ ロト タイブには引数名を宵かなければなりませ 


Argument list syntax error 

関数を呼び出す際の引数は，カンマで区切り，最後は右カツコ’)’で閉じなければなり 
ません。ソースコード中の引数の後に，カンマあるいは右カツコ以外の文字が絞いて 
います。 


Array bounds missing j 

ソースファイル中で配列が宣言されていますが，配列の範囲が右大カッコ’]’で閉じら 
れていません。 

Array size too large 

宣言された配列が大きすぎて，メモリにおさまりません。 


ェラー 
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Assembler statement too long 

インラインアセンブリ文が 480 バイトを越えてしまいます。 

Bad configuration file 

TURBOC . CFG ファイルの中に，コメントでないテキストで，コマンドラインオブシ 
ョンとして正しくないものがあります。コマンドラインオプションは，マイナス符号 
(-) で始まっていなければなりません。 

Bad file name format in include directive 

インクルードされるファイル名は，二重引用符または不等号 

で囲まれていなければなりません。ファイル名の左側にそのどちらか 
がつけられていません。マクロが使われている場合は，展開されたテキストが正しく 
ありません。 

Bad ifdef directive syntax 

# ifdef 指令は，指令の本体としては，識別名は1個しか含むことはできません。 

Bad imaef directive syntax 

# ifndef 指令は，指令の本体としては，識別名は1個しか含むことはできません。 

Bad undei directive syntax 

# undef 指令は，指令の本体としては，識別名は1個しか含むことはできません。 

Bit field size syntax 

ビットフィールドの幅は，1〜16の間の定数で定義しなければなりません。 

Calloi non-function 

関数として宣言されていないものを呼び出しています。これは，関数の宣言が正しく 
ないか，関数名をスペルミスしたことに原因があります。 

Cannot modily a const object 

const と宣言されたオブジェクトに対して，代入などの許されない操作が行なわれて 
います。 
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Case outside of switch 


switch 文の外側に case 文がありました。おそらく と’}’が正しく対応していません 

(どちらかがない）。 

Case statement missing ： ! 

case 文では，定数式の後にコロン （ ： ） が必要です。 case 文の式にコロンをつけるの 
を忘れたか，コロンの前によけいなシンボルがついているはずです。 

Cast syntax error 

キャストが正しくないシンボルを含んでいます。 


Character constant too long 

文字定数は，1文字か2文字の M さしか許されません。 


Compound statement missing ： } 

ソースファイルの 終わりまで達したのに，右 カッコ ’}’ がありませんでした。おそらく’ 
{’ と’}’が正しく対応していないことによります。 

Conflicting type modifiers 

これは，1つのポインタの宣言で，予約語 near と far の両方を指定したときなどに出 
力されます。1つのポインタには1つのアド レ シング修飾子，1つの関数には1つの言語 
修飾子 （ cdecl , pascal ， または interrupt ) しか指定できません。 

Constant expression required 

配列は定数の大きさで宣言されなければなりません。このエラーは，# define 定数のス 
ペルミスによってよく起こります。 

Could not find file ’XXXXXXXX.XXX’ 

コマンドラインで指定されたファイルが見つかりませんでした。 

Declaration missing ； 

ソースフアイルの中に，最後にセミコロン （ ： ） のない Struct または union のフイー 
ルド宣言が含まれています 0 


エラー 
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次のような宣言 


Declaration needs type or storage class 

宣言には，少なくとも型か記憶クラスの指定が必要です。たとえば， 
文は正しくありません。 


Declaration syntax error 

ソースファイルの中に，シンボルが欠けている，あるいはよけいなシンボルを含む宣 
言があります。 


Default outside of switch 

switch 文の外側に default 文がありました。おそらく ’{• と’}’が正しく対応していませ 



Deiine direcuve needs an idenufier 

# define の後の（ホワイトスペース以外の）®:初の文字は，識別名でなければなりませ 
ん。。贷別名とは考えられない文字がありました。 


Division by zero 

ソースファイルの中に，ゼロで割る式があります。 


Do statement must have while 

do 文の中に，予約語 while がありません。 

Do-while statement missing ：( 

do 文の中で，予約語 while の後に左カツコ’(’がありません。 

Do-while statement missing ) 

do 文の中で，条件式の右カツコ’)’がありません。 

Do-while statement missing • 

do 文の中で，条件式の右カツコの後にセミコロン（：）がありません。 

Duplicate case 

switch 文の各 case の定数式は，他の case と異なるものでなければなりません 0 
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Enum syntax error 

enum 宣言の識別名の並びが正しくありません。 


Enumeration constant syntax error 

enum の値として与えられている式が定数ではありません。 


Error Directive : XXXX 

このメッセージは，ソースファイル中の# error 指令が実行されたときに表示されま 
す。指令のテキストがメッセージの中に表示されます。 


Error writing output file 

この エラーは • 作業用ディスクがいっぱいになった場合によくでます。ディスケット 
が壊れているような場合にもでます。いっぱいの場合は，不要なファイルを消去して, 
もう一度コンハ•イルを行なってください。 

Expression syntax 

式の解析において? R 大なエラーがあった場合に，このメッセージが出力されます。2つ 
の谀算子が連絞して現われたり，カツコの対応していなかったり，前の文のセミコロ 
ンがない場合などです。 


Extra parameter in call 


ブロトタイブで定義されたポインタによる関数呼び出しで，引数が多すぎます。 


Extra parameter in call to XXXXXXXX 

(プロトタイプで宣言された）関数の呼ひ•出しで，引数が多すぎます。 

File name too long 

# include 指令で指定されたファイル名が長すぎて，コンパイラが処理できません。 
MS - DOS におけるファイル名は64文字以下でなければなりません。 

For statement missing ( 

for 文で， for の後に左カツコ’ (’ がありません。 


For statement missing ) 

for 文で，制御式の後に右カッコ ’)’ がありません。 


エラー 
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For statement missing ； 

for 文で，式の後にセミコロン’：’がありません。 

Function call missing ) 

関数呼び出しの引数の並びに構文エラーがあります。たとえば，右カツコの指定を忘 
れたりした場合です。 

Function deiinition out of place 

関数定義は，他の関数の内部にくことはできません。関数の内部にある，引数リス 
卜をともなう関数の始まリのような宣言は，関数定義とみなされます。 

Function doesn't take a variable number of arguments 

可変個の引数をとることができない関数で， va start マクロが使用されています。 

Goto statement missing label 

予約語 goto の後には，識別名が必要です。 

If statement missing ( 

if 文において，予約語 if の後に左カツコ’(’がありません。 

If statement missing ) 

if 文において，粂件式の後に右カツコ T がありません。 

Illegal character ， C ，（ 0xXX) 

人カファイルの中に無効な文字が使われています。その文字の16進値も表示されます。 

Illegal initialization 

初期化は，定数式，または，グローバルな外部 （ extern ) 変数あるいは static 変数の 
アドレスに定数を足すか，引くかしたものでなければなりません。 

Illegal octal digit 

8進定数の中に，8進数字としては許されない数字 （8 または 9) があります。 

Illegal pointer subtraction 

これは，ポインタでないものからボインタを引こうとしたときに出力されます。 
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Illegal structure operation 

構造体に使用できる演算子は，ピリオド （.）， アドレス of 演算子 (&), 代入演算子 （=) 
であり，また構造体は関数への（からの）引数として指定できます。構造体がこれ以 
外の演算子とともに使用されていると，このエラーが出ます。 

Illegal use oi floating point 

浮動小数点オペランドに対して，シフト，ビット論理演辟，条件式 （？ ：），問接参 
照 （*) などの演算を行なうことはできません。浮動小数点オペランドが，これらの 
使用できない演烊子とともに使われています。 

Illegal use of pointer 

ポインタに対しては，加算，減箨，代人，関係，間接 （*), 矢印 （->) の演算子しか 
使用できません0ソースファイルの中で，ポインタが他の演算子とともに使われてい 
ます。 


Improper use of a typedef symbol 

式の中で， typedef 名が，変数を SK くべき場所に使われています。 typedef 宣言とスぺ 
ルミスがないかどうかチェックしてください。 


In-line assembly not allowed 

ソースファイルにはインラインアセンブリ文が含まれていますが，それを統合 S 3 境の 
中からコンバイルしようとしています 0 このソースファイルを コン ハ•イルするには， 
TCC コマンドを使用する必要があります。 


Incompatible storage class 

ソースファイルの中で，関数定義に対して予約語 extern が使われています。関数定義 
には，記憶クラスとしては，何もなしか，つけるとすれば static しか使用できません。 


Incompatible type conversion 

ある型から別の型への変換をしようとしていますが，この2つの型はコンパチブルでは 
ありません。これには，関数と非関数の間，構造体や配列とスカラ型の間，浮動小数 
点値とポインタ型の間などの変換が含まれます。 

Incorrect command line argument : XXXXXXXX 

この コマン ドライン引数は，正当なものとは認められません。 


エラー 
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Incorrect confiugration file argument : XXXXXXXX 

コンフイギユレーシヨンファイル内のこの引数は，正当なものとは認められません。 
特に，マイナス符号㈠がついているかチェックしてください。 


Incorrect number format 

16進表記の中に小数点が現われました。 


Incorrect use of detault 

予約語 default の 後に コロン （ ： ） がありません 0 


Initializer syntax error 

初期化において，演烊子がたりない，余計な演坪-子がある，カツコが正しく対応して 
いない，など冉式として受け入れられません。 

Invalid mairection 

間接演许子 （*) のオペランドは， void ではないポインタでなければなりません0 


Invalid macro argument separator 

マクロ定莪内の引数は，カンマで区切られていなければなりません。引数名の後に別 
の文字がありました。 


Invalid pointer addition 

2つのポインタを足し合わせようとしています。 

Invaild use oi arrow 

矢印浈抹子 （->) の後ろには，識別名を 1K かなければなりません。 

Invaild use of dot 

ドット演算子 （•） の後ろには，識別名を！ S かなければなりません。 

Lvalue required 

代入演箨子の左辺は，値を代入するアドレスが特定できる式でなければなりません。 
これには，数値変数，ポインタ変数，構造体フィールド参照，ポインタによる間接参 
照，配列要素などが含まれます。 
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Macro argument syntax error 

マクロ定義における引数は識別名でなければなりません。引数が現われるべき位菌に 
識別名には許されない文字が使われています。 


Macro expansion too long 

マクロは 4096 文字以上に展開することはできません。このエラーは，マクロがそれ自 
身を再帰的に展開しようとする場合に起こります。マクロは自分自身を正しく展開す 
ることはできません。 


Riay compile only one file when an output file name is given 

コマンドラインオプション - o を指定すると出カファイルは 1 個のみとなるので，先頭 
のフアイルだけがコンバイルされ，他のファイルはコンバイルされません。 


Mismatched number of parameters in definition 

関数定義における引数が，関数ブロトタイブで与えられた悄報と一致しません。 

Misplaced break 

switch 文の外側，あるいはループの外側に break 文があります。 

Misplaced continue 

switch 文の外側，あるいはループの外側に continue 文があります。 


Misplaced decimal point 

浮動小数点定数の指数部に小数点があります。 


Misplaced else 

if 文と対応しない else 文があります。これは，単によけいな else がある場合の他に， 
よけいなセミコロンがある，や’}’を入れ忘れている，前の if 文の中に構文エラーが 
ある場合などに起こります。 


Misplaced elif directive 

# if , # ifdef , # ifndef に対応しない# elif 指令があります。 
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Misplaced else directive 

# if , # ifdef , # ifndef に対応しない# else 指令があります。 

Misplaced endif directive 

# if , # ifdef , # ifndef に対応しない# endif 指令があります。 

Must be addressable 

& 演算子が，特定のアドレスに菌かれないオブジェクト，たとえばレジスタ変数などに 
使用されています。 

Must take address of memory location 

アドレス of 演钚子 （&> が式の中で，許されない使い方をされています。たとえば， 
レジスタ変数などに対して使用されています。 

No file name ending 

# include 文のファイル名を閉じる不等号 （>) あるいは二承引用符 （”） がありませ 
ん〇 

No ule name given 

TurboC のコンパイラ （ TCC ) に，ファイル名が指定されていません。ソースフアイ 
ル名を指定しなければなりません0 

Non-portaoie pointer assig：nmeni 

ソースファイルの中に，ポインタをポインタでないものへ代入する文，あるいはその 
逆の代入を行なう文があります。特殊なケースとして，定数0をポインタに代入するこ 
とは許されています。代入そのものが適切なのであれば，このエラーメッセージが出 
ないようにするために，キャストを使用してください。 

Non-portable pointer comparison 

ソースファイルの中で，ポインタとポインタ以外のものとの比較が行なわれています。 
ポインタは，ポインタ以外のものでは定数0としか比較できません。比較そのものが適 
切なのであれば，このェラーメッセージが出ないようにするために，キャストを使用 
してください。 
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Non-portable return type conversion 

return 文の中の式の型が，関数宣言の型と一致していません。1 つの 例外を除いて，関 
数または return 文の式がポインタの場合にはこのエラーがでます。例外は，ポインタ 
を返す関数が定数0を返す場合です。0は適切なポインタ値に変換されます。 


Not an allowed type 

ソースファイルの 中で，許されない型，たとえば関数を返す関数， fld 列を返す関数な 
どを宣言しています。 

Out of memory 

使用できるメモリがなくなリました。メモリを增設する必要があります。すでにメイ 
ンメモリに 640 KB を実装しているのであれば，デバイスドライバを滅らして利用でき 
るメモリをふやすか，ブログラムを分割するなどしてソース ファ イルを小さくする こ 
とを考えてください。 

Pointer required on left side of -> 

矢印演算子 （->) の左側にはポインタしかけません。 

Redeclaration of ’XXXXXXXX* 

この識別名は，以前に宣言されています。 


Size of structure or array not known 

sizeof のような式が，未定義の構造体や長さが空の配列とともに使われました 。黯 
体は，その大きさが必要なければ，定義の前に参照することができます。配列は，メ 
モリ領域を確保するのではない場合や，長さを与える初期化子が後に絞く場合は，長 
さを空にして宣言ができます。 

Statement missing ; 

歧後にセミコロンがついていない文があります。 


Structure or union syntax error 

予約語 struct または union の後に，識別名あるいは’ {，がありません。 


Structure size too large 

メモリに入りきらない大きさの構造体を宣言しています。 
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Subscripting missing ] 

右カツコ’]’がない添字式があります。これは演諄子を入れなかったり，余計に入れて 
しまったり，カツコの対応が悪い時にでるエラーです A 


Switch statement missing ( 

switch 文で，キーワード switch の後に左カッコ’（，がありません。 


Switch statement missing ) 

switch 文で，判定式の後に右カッ つ，），があ 1 ) ません。 


Too few paraments in call 

(関数ポインタによる）ブロトタイブを持つ関数への呼ひ•出しにおいて，引数の数が 
少なすぎます。プロトタイプは，すべての引数が渡されることを要求します。 

Too few parameters in call to XXXXXXXX* 

(プロトタイプで宣言された）関数の呼び出しにおいて，引数の数がたりません。 


Too many cases 

switch 文のケースの数の上限は 257 です。 


Too many decimal points 

浮動小数点定数中に小数点が沒数ありました。 


Too many default cases 

1 つの switch 文の中に default 文が褀数ありました。 


Too many exponents 

浮動小数点定数の中に指数部が複数ありました。 

Too many initializers 

宣言によって許される個数以上の初期化子が存在します。 

Too many storage classes in declaration 

i つの宣言は，複数個の記值クラスを持つことはできません。 
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Too many types in declaration 

1 つの宣言は，複数個の型を持つことはできません。型は次の基本型のいずれかです。 

char , int ， float , double, struct , union, enum , typedeT 名 

Too much auto memory in function 

现在の関数は，使用できるメモリ以上の自動記«領域を宣§している 〇 

Too much code denned in file 

現在のソースファイルの中の関数を合わせた大きさが 64 K バイトを越えました。必要 
のないコードを削るか，ソースファイルを分割するかしてください。 

Too much global data denned in file 

グローハ•ルなデータ宣言の総計が 64 K バイトを越えました。大きすぎる配列がないか 
調べてください。全部が必要な場合は，ブログラムの再編成を考えて〈ださい。 

Two consecutive dots 

3つの速絞したピリオド (...) は«略を意味し，1個のピリオドは小数点やメンバを指 
定するのに使われます。しかし，2つの連絞するピリオドは C では使われません。 

Type mismatch in parameter w 

(関数ポインタによって呼び出される）関数がブロトタイプとともに宣言されていて, 
左から# N 番目の引数は宣言の引数型に変換されることができませんでした。 

Type mismatch in parameter # in call to ’XXXXXXXX ， 

ソースファイルの中で，関数がブロトタイブとともに宣言されていますが，左から# N 
番目の引数を，宣言の引数型に変換することができませんでした。 

Type mismatch in parameter ’XXXXXXXX’ 

ソースファイルの 中で，関数ポインタによって呼び出される関数がブロトタイプとと 
もに宣言されていますが，引数を宣言の引数型に変換することができませんでした。 

Type mismatch in parameter ’XXXXXXXX’ in call to 9 YYYYYYYY f 

ソースファイルの中で，関数がプロトタイプとともに宣言されていますが，引数を宣 
言の引数型に変換することができませんでした。 
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Type mismatch in redeclaration of ’XXX’ 

ソースファイルの中で，ある変数が，もともと宣言された型とは異なる型に再宣言さ 
れています。これは，ある関数がまず呼び出され，その後で! S 数とは違うものを返す 
と宣言された場合に起こります。このエラーが出る場合は，その関数が骹初に呼び出 
される前に，関数の extern 宣言を入れます。 

Unable to create output file ’XXXXXXXX.XXX ， 

このエラーは，作龙用ディスクがいっぱいになったり，ライトプロテクトされている 
場合に出ます。いっぱいの場合は，个必要なファイルを削除し，コンパイルをやリ槪 
します。ライトプロテクトされている場合は，そのソースファイルを#き込み可能な 
デイスクにコピーして，コンパイルをやりしてください。 


Unable to create turboc.lnk 

コンパイラがテンポラリファイル TURBO.SLN を作成することができません。この 
エラーは，コンバイラがディスクをアクセスできないか，ディスクがいっぱいの場合 
に出ます。 

Unable to execute command ’XXXXXXXX* 

TLINK または TASM が見つかりません。またはディスクが壞れています。 

Unable to open include file ’XXXXXXXX.XXX’ 

コンバイラが指定のファイルを見つけられませんでした。このエラーは，インクルー 
ドファイルが n 分自身をインクルードしている場合にも出ます。指定のファイルが存 
在しているかチェックしてください。 

Unable to open input file ’XXXXXXXX.XXX* 

このエラーは • ソースファイルが見つからなかった場合に出ます。ファイル名のスべ 
ルと，そのフアイルが指定のディスクやディレクトリに存在しているかどうかをチェ 
ックしてください。 

Undefined label ^XXXXXXXX* 

goto 文で使用されているラベルの定義がありません。 


Undefined structure ’XXXXXXXX ， 
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構造体を，エラーが示されているところより前で使用していますが，その構造体に対 
する定義がありません。このエラーは，構造体名をスペルミスしたか，宣言を忘れた 
場合にでます。 

Undefined symbol ’XXXXXXXX’ 

この識別名は宣言されていません。これは，この行あるいは宣言を行なっている行で 
スペルミスをしていることによって起こります。この識別名の宣言でエラーが起こっ 
ている場合にも，このエラーはでます。 


Unexpected end of file in comment started on line ft 

コメントの途中で，ソースファイルが終わっています。このエラーは，通常はコメン 
卜の終わりの記号 （*/) を忘れたことで起こります。 


Unexpected end of me m conditional started on line # 

コンパイラが# endif に出会う前にソースの終わりが现われました。# endif を入れ忘 
れたか，スペルミスが哚因です。 

Unknown preprocessor directive : ’XaX’ 

行の初めに文字#がありますが，それに絞く指令名が次のいずれでもありませんでし 
た。 

define, undef， line, ii, iidef, ifndef, include, else, endif 


Unterminated character constant 


対応していない单引用符があります。 


Unterminated string ： 

対応していない二重引用符があります。 

Unterminated string or character constant 

文字列あるいは文字定数が始まっていますが，それを終了させる引用符がありません。 

User break 

統合環境でコンバイル中あるいはリンク中に， CTRL-STOP ( Ctrl - Break ) が入力され 
ました。 
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While statement missing ( 

while 文で，判定式の後の右カッコ’(’がありません。 

While statement missing：) 

while 文で，判定式の後の右カッコ ’)’ がありません。 

Wrong number of arguments in call of , XXXXXXXX , 

マクロの呼び出しで，引数の個数が定義と一致していません。 
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警告 


’XXXXXXXX’ declared but never used 

指定の変数がソースファイル中で宣言されていますが，全く使われていません。この 
警告は，梭合文，つまリ関数の終わりのカッ コ ’}’ にコ ンパイラが出会った段階で出力 
されます。変数の宣言は複合文，つまり関数の初めで始まります。 

， XXXXXXXX，is assigned a value which is never used 

変数は代入文には使われていますが，その他では全く使われていません。 この 餐告は 
コンパイラが終わりの’}’カッコに出会った段階で出力されます。 

’XXXXXXXX’ not part of structure 

指定のフイールドは，ドット （•） または矢印 （->) の左側にある構造体の一部分でな 
いか，あるいは左側にあるものが構造体でない（ドットの場合）か，構造体を指すポ 
インタ（矢印の場合）ではないことを意味します。 

ambiguous operators need parentheses 

この警告は，2つのシフト演算子，関係演算子，ビット論理演算子がカッコなしに連絞 
して現われたときに出力されます。また，加算あるいは滅算演算子がカッコ なしに シ 
フト演算子とともに現われた場合にもこの餐告が出ます。演算子の*先順位は，やや 
胙感的にとらえにくい点があり，ブログラマはよく優先順位を間違えがちです。 

Botn return and return of a value used 

一の警告は，コンパイラが関数の中の前の return 文とは一致しない return 文に出会 
った段階で出力されます。値を返す return 文と，値を返さない return 文があるとい 
うことなので，これはおそらくエラーです。 

Call to function with no prototype 

この メツセージは ， ’’Prototypes required ，，警告が許可されて，プロトタイプを最初に 
与えずにその関数を呼び出した場合に出力されます。 


警告 
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Call to function ’XXXX’ with no prototype 

このメッセージは， ’’ Prototypesrequired ” 警告が 許可されていて，プロトタイプを 最 
初に与えずに関数 XXXX を呼び出した場合に出力されます。 


Code has no effect 

この 膂告 は，コンパイラが，何の効果もない 演算子を 含む文があったときに出力され 
ます。たとえば次の文は， 


a + b ; 

どちらの変数に対しても何も影®を与えません。こうしたものは不要であり，なんら 
かのバグを意味していることもあります。 

Constant is long 

コンパイラが，32767より大きい10進定数，あるいは65535より大きい8進（または16進） 
定数で最初に丨や L の文字がついていないものがあった場合に出力されます。これら 
の定数は long として扱われます。 

Constant out oi range in comparison 

ソースファイル中に，ある定数部分式がもう 1 方の部分式の型によって許される範囲の 
外側にある場合の比較が含まれています。たとえば unsigned の値を-1と比較するよ 
うな場合です。32767 (10 進）より大きい unsigned 型にキャストする（たとえば ( un ¬ 
signed ) 65535) か， 定数の®:後に u または U をつけます（たとえば65535 u )。 

このメッセージが出力されても，コンパイラは比較のためのコードを生成します。こ 
のコードが常に同じ結果を与えるもの（文字式を4000と比較するといったもの）であ 
っても，必らず判定は行なわれます。これにより unsigned 型の式と-1を比較しても意 
味があるということになります。実際 （ unsigned ) 65535と-1は，8086上では同じビッ 
トパターンを与えるからです。 
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Conversion may lose significant digits 

代入文などにおいて， long あるいは unsigned long から， int あるいは unsigned int 

への変換が行なわれる場合があります 0 マシンによっては， int と long の変数が占め 

るバイト数が同じ場合もあるので，この棟の変換がプログラムの動作を変えてしまう 
ことがあります。 

この メッセージを 出力した場合には， コンハ •イラは比較を行なうコードを生成します。 
char 型の式を 4000 と比較するような場合に，生成したコードが常に同じ結果を示すと 
しても，このコードはやはり比較を行ないます。これは， unsigned の式と- 1 との比較 
でも有効な場合があることを意味します。 8086 においては， unsigned の値が， -1 と同 
じビットパターンをとることもあり得るからです。 


Funcuon should return a value 

この関数は， int 型や void 型以外の型の値を返すと宣言されているのに，値を返さない 
return 文が使われています。おそらくはエラーです。古いタイプの C では，値を返さ 
ない関数であることを意味する void 型がなかったので， int と 宣3 ■されている場合 
はこの メッセージは 出ません。 


Hexadecimal or octal constant too large 

文字列リテラルあるいは文字定数において，255を越える侦（たとえば¥777や ¥ xl 234) 
を持つ16進または8進エスケープシーケンスが指定されています。 

Mixing pointers to signed and unsigned char 

char ポインタから uns ig ne d char ポインタへの変換（あるいはその逆）を，キャスト 

なしで行なつています（厳密にいうとこれは間違いですが，8086ではあまり問題にな 
りません）。 

No declaration for function ， XXXXXXXX ， 

これは，この警告がオンになっていて (- wnod ), 関数を宣言せずに呼び出している場 

合に出力されます。宣言は古典•モダン（プロトタイプ)，いずれのスタイルでもかま 
いません。 


Non-portable pointer assignment 

ポインタをポインタでないものへ代入（あるいはその逆）しています。ポインタに〇を 
代人することは，特別な場合として許されています。この警告を出さないようにキャ 
ストすべきです。 


警告 
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Non-portable pointer comparison 

ポインタを 0 以外のポインタでない値と比較しています。比較が適切な場合，この！?告 
を出さないようキャストすべきです。 


Non-portable return type conversion 

return 文の中の式の型が，関数宣言の型と同じではありません。関数または戻り値が 
ポインタの場合にこのエラーがでます。 唯一の 例外は，ポインタを返す関数が定数0を 
返す場合です。0は適当なポインタ値に変換されます。 

Parameter XXXXXXXX* is never used 

関数の中で宣言された引数が，関数本体の中で使用されていません。エラーかどうか 
は確定できませんが，引数のスベルミスによってよく起こります。また関数の本体で 
自動（ローカル）変数として再宣言されている場合もあります。この場合，引数が自 
動変数によってマスクされ，未使用のままになります。 

Possible use of XXXXXXXX* before definision 

変数に値が代人される前に，その変数が式の中で使われています。この点に関してコ 
ンバイラが行なう倹奄は簡取なもので，変数の使用が代入よりもソースコード中で物 
理的に前にあると，この警告が出ます。実際のブログラムの流れでは，使用する前に 
代入されるのかもしれません。 

Possibly incorrect assignment 

この警告は， if 文， while 文， do-while 文などで，条件式の主たる演算子が代入演算子 
であった場合に出力されます。==演算子とまちがえて，二を使っている場合によく起 
こるものです。この警告を抑制するには，代入文をカツコで囲み，その全体としての 
値とゼロとの比較を明示的に行なってください。たとえば次の式を， 

if (a _ b) … 

次のように氍き変えます。 

if ((a - b) !- 0)... 


Redefinition of ’XXXXXXXX’ is not identical 

前に定義されているマクロを，別のテキストで再定義しています。この場合マクロは 
新しいテキストで置き換えられます。 
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Restarting compile using assembly 

-B コンパイラオプション，あるいは# pragma inline 文の指定なしで， asm 文に出会 
いました。アセンブリ言語機能を使用して， コン ハ•イルをリスタートします。 


Structure passed by value 

この??告をオンにしている場合 (- wstv ), 構造体が引数として値で渡されていると， 
この瞥告がでます 0 よくあるのは，引数として構造体のアドレスを渡すべきところ 
で，&演»:子をつけ忘れることです。構造体は値で渡すこともできるのでエラーとはな 
リません。この費告は，ブログラムミスを気づかせるためのものです。 


Superfluous & with function or array 

アドレス of 演羝子 （&> は配列名や関数名につける必要はありません。この場合&演 
算子は削除されます。 

Suspicious pointer conversion 

異なる型を指すポインタの問で変換を行なっています。その変換が適切なものである 
ならば，この膂告を出さないようにするためにはキャストを使用してください。 

Undefined structure ’XXXXXXXX ， 

ソースフアイルの中で使用されている構造体 xxxxxxxx は，定義されていません。 
これは，梆造体名のスペルミス，あるいは宣言がないことによって起こります。 

Unknown assembler instruction 

インラインアセンブリ文に許されない命令コードが使われています。命令コードをチ 
エックしてください。命令が受け入れられるものかどうか，3午されている命令コード 
の一览表もチヱックしてください（ユーザーズガイド第12章)。 


Unreachable code 

break ， continue , goto , return の後に，ラベル，あるいはルーブや関数の終わりが 
絞いていません。コンハ•イラは，条件判定式が定数の while , do , for ループをチェッ 
クし，無限ループを認識しようとします。 


Voia functions may not return a value 

この関数は void 型と宣言されているのに，値を返そうとする return 文があります。 
return 文の値は無視されます。 


警告 
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Zero length structure 

大きさがゼロの構造体が宣言されています。この構造体を使用するとエラーになりま 
す0 
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付録 B 


言語の構文の要約 


ここでは， TurboC における構文の要約を行ないますが， BNF (バッカス-ナウア記法） 
を少し修正したものを使用することにします。次のように3つのカテゴリにわけて説明を行 
ないます。 

■語意に関する文法： トークン，キーワード，識別名，定数，文字列リテラル，演筋子, 
区切子 

■フレーズの構文に間する方法： 式，宣言，文，外部定莪 

■プリプロセッサ指令 

WT 文中のオプション（拆略可能）の要素は，不等号記号（く...〉）で囲んであります。 
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語意に関する文法 


トークン 


トークン： 

キーワード 
謙別名 
定数 
文字列 
演算子 
区切子 

キーワード（予約語) 


キーワード：以下のうちの1つ 


asm 

do 

goto 

return 

union 

auto 

double 

huge 

short 

unsigned 

break 

else 

if 

signed 

void 

case 

enum 

int 

sizeof 

volatile 

cdecl 

extern 

interrupt 

static 

while 

char 

far 

long 

struct 

_cs 

const 

float 

near 

switch 

_ds 

continue 

for 

pascal 

typedef 

es 

default 


register 


ss 
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識別名 


班別名： 

非数字 

雄別名非数字 
斑別名数字 

非数字：以下のうちの1つ 

abcderghijklmnopqrstuvwxyz^ $ 
ABCDEFGHIJKLMNOPQRSTUVWXYZ 


数字： 以下のうちの 1 つ 




定数 


定数： 

浮動小数点小数 
整定数 
列挙型定数 
文字定数 

浮動小数点定数： 

小数点定数く指数部〉く浮動小数点接尾辞〉 
数字の並び指数部く浮動小数点接尾辞〉 


小数点定数： 

く数字の並び〉.数字の並び 
数字の並び. 


除意に関する文法 
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指数部： 

e く符号〉数字の並び 
E く符号〉数字の並び 

浮動小数点接尾辞 


数字の並び： 

数字 

数字の並び数字 

浮動小数点接尾辞： 以下のうちの1つ 
f 丨 F し 

整定数： 

10進定数く整数接尾辞〉 

8進定数く整数接尾辞〉 

16進定数く整数接尾辞〉 

10進定数： 

非ゼロ数字 
10進定数数字 

8進定数： 

0 

8進定数8進数字 

16進定数： 

0 x 16 進数字 
0 X 16 進数字 
16進定数16進数字 

非ゼロ数字： 以下のうちの1つ 
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8 進数字： 以下のうちの 1 つ 


16進数字： 以下のうちの 1 つ 

0 1 2 3 4 5 

a b c d e f 

A B C D E F 

整数接尾辞： 

符号なし接尾辞く倍長接尾辞〉 
倍長接尾辞く符号なし接尾辞〉 

符号なし接尾辞： 以下のうちの1つ 
u U 

倍長接尾辞： 以下のうちの1つ 


列挙型定数： 

»別子 

文字定数： 

c 文字の並び 

C * 文字の並び： 

文字 

C 文字の並び C 文字 
C 文字： 

ソース記述文字セットの文字ならどんな文字でも。ただし，単引用符（，)，円記号 
(¥), 改行文字を除く。 

エスケープシーケンス 


B 意に関する文法 
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エスケープシー 

ケンス 

以下のうちの 1 つ 


V ， 

Vb 

Vv 

Vxhh 

¥，， 

¥f 

Vo 

¥ xhhh 

V? 

¥n 

¥〇〇 

VXh 

¥ ¥ 

Vr 

Vooo 

VXhh 

Va 

Vt 

Vxh 

VXhhh 


文字列リテラル 


文字列リテラル： 

"<5文字の並び〉 


5文字の並び： 

• S 文字 

• S 文字の並び S 文字 


J 文字： 

ソース記述文字セットの文字ならどんな文字でも。ただし，二 ® 引用符 （”)， 円記号 
(¥), 改行文字を除きます。 

エスケープシーケンス 
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演算子 


演算子：以下のうちの1つ 

[] 0 

& * 

sizeof / 

> < = 

• I 

*= / = 

>>= & = 

## 




&& 

% = 





» 





« = 



区切子 


区切子：以下のうちの1つ 

[] 0 {} * 



語意に関する文法 
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フレーズの構造に関する文法 


式 


一次式： 

嫩別子 

定数 

疑似変数 
文字列リテラル 
(式） 


疑似変数 


AX 

_AL 

AH 

SI 

— ES 

BX 

B し 

BH 

DI 

SS 

CX 

C し 

CH 

BP 

CS 

DX 

D し 

DH 

SP 

DS 


ボストフィックス式： 

一次式 

ボストフィックス式[式] 

ボストフィックス式（く引数式リスト〉) 
ボストフィックス式.进別子 
ポストフィックス式-〉»別子 
ボストフィックス式+ + 

ボストフイックス式 一 


引数式リスト： 

代入式 

引数式リスト，代入式 
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単項式： 


ボストフィックス式 
++単項式 
一単項式 

単項演算子キャスト式 
sizeof 単項式 
sizeof ( 型名） 

単項演算子：以下のうちの1 つ 

& * + - ' 

キャスト式： 

単行式 

(型名）キャスト式 


乗法式： 

キャスト式 

乗法式 * キャスト式 
乗法式 / キャスト式 
乗法式％キャスト式 


加法式： 
乗法式 


加法式+乗法式 
加法式-乗法式 


シフト式： 

加法式 

シフト式くく加法式 
シフト式〉〉加法式 


関係式： 

シフト式 

関係式く シフト式 
関係式〉シフト式 


フレーズの構造に関する文法 
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関係式 <= シフト式 
関係式〉=シフト式 

等号式： 

関係式 

等号式==関係式 
等号式！=シフト式 

AND 式： 

等号式 

AND 式&等号式 

排他的 OR 式： 

AND 式 

排他的 OR 式 ， AND 式 

OR 式： 

排他的 OR 式 

OR 式 排他的 OR 式 

論理 AND 式： 

OR 式 

論理 AND 式&& OR 式 

論理 OR 式： 

論理 AND 式 

論理 OR 式 論理 AND 式 

条件式： 

論理 OR 式 

論理 OR 式？式：条件式 

代入式： 

条件式 

単行式代入 演算子 代入式 
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代入演算子：以下のうちの1つ 

= *= /= %= += -= 
«= »= &= = = 

式： 

代入式 
式，代入式 

定数式： 

条件式 

宣言 


宜言： 

宜言指定子く初期値宜言リスト〉 
宜言指定子： 

記憶クラス指定子く宜言指定子〉 
型指定子く宜言指定子〉 


初期値宜曾リスト： 

初期値宜首子 

初期値宜言リスト，初期値宜言子 

初期値宣言子： 

宣言子 

宜首子=初期化子 


フレーズの構造に関する文法 
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記憶クラス指定子： 
typedef 
extern 
static 
auto 
register 

型指定子： 
void 
char 
short 
int 
long 
float 
double 
signed 
unsigned 
const 
volatile 

構造体 • 共用体指定子 
列挙型指定子 
typedef 名 

構造体 • 共用体指定子： 

構造体•共用体く》別名〉{構造体宜言リスト} 
構造体•共用体》別名 

構造体 • 共用体： 


struct 



構造体宜首リスト： 

構造体宣言 

構造体宜首リスト構造体宜首 
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構造体宣言： 

型指定子リスト構造体宣言子リスト； 

型指定子リスト： 

型指定子 

型指定子リスト，型指定子 

構造体宜 S リスト： 

構造体宜苜子 

構造体宜首子リスト，構造体宜言子 

構造体宜言子： 

宜首子 

く宜首子〉：定数式 
列挙型指定子： 

enum く嫌別名〉 { 列挙子リスト} 
enum K 別名 

列挙子リスト： 

列挙子 

列挙子リスト，列挙子 

列挙子： 

列挙型定数 

列挙型定数=定数式 

宜首子： 

くポインタ〉直接宜*子 
く修飾子リスト〉 


フレーズの構造に関する文法 


787 



直接宜言子： 

m 別名 
( 宣首子） 

直接宣言子[く定数式〉] 

直接宜言子（パラメータ型リスト） 
直接宜首子（く班別名リスト〉） 

ポインタ： 

* く型指定子リスト〉 

* く型指定子リスト〉ポインタ 


修飾子リスト： 

修飾子 

修飾子リスト修飾子 


修飾子： 


cdecl 

pascal 



near 

far 

huge 


パラメータ型リスト： 
パラメータリスト 
パラメータリスト，••• 


引数リスト： 

引数宜首 

引数リスト，引数宜言 


パラメータ宜首： 

宣富指定子宜 S 子 

宜*指定子く抽象宜言子〉 
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臌別名リスト： 

嫌別名 

識別名リスト，雄別名 
型名： 

型指定リストく抽象宜曾子〉 

抽象宜言子： 

ポインタ 

くポインタ〉く直接抽象宜言子〉 

く修飾子リスト〉 

直接抽象宜言子： 

( 抽象宜曾子） 

く直接抽象宜曾子〉[く定数式〉] 

く直接抽象宜言 子〉 （く パラメータ型 リスト〉) 

typedef 名： 

»別名 

初期化子： 

代入式 

{ 初期化子リスト} 

{ 初期化子リスト，} 

初期化子リスト： 

初期化子 

初期化子リスト，初期化子 


フレーズの構造に M する文法 
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ラベルつき文 
複合文 
式文 
選択文 
繰り返し文 
飛び越し文 
asm 文 

asm 文： 

asm トークン改行 
asm トークン； 

ラベルつき文： 

»別名：文 
case 定数式 文 
default :文 

複合文： 

{く宜言リスト〉く文リスト〉} 

宜首リスト： 

宜苜 

宜首リスト宜 S 

文リスト： 

文 

文リスト文 

式文： 

く式〉； 

790 付霣晤の構文の要約 



選択文： 

if (式）文 
if (式）文 else 文 
switch (式）文 


繰り返し文： 

while (式）文 

do 文 while (式）； 

for (く 式〉；く 式〉；く 式〉）文 

飛び越し文： 

goto 雄別名； 
continue . 
break ； 
return く 式〉； 


外部定義 


ファイル： 

外部定義 

ファイル 外部定義 


外部定義： 

間数定義 

宜 S 

関数定義： 

く宜首指定子〉宜*子く宜言リスト〉複合文 


プリプロセッサ指令 



_ プリプロセッサ指令 

プリプロセッシングファイル： 

グループ 

グルーブ： 

グルーブ部 

グループグループ部 

グループ部： 

<即トークン〉改行 
if セクション 

制御行 

//セクション： 

if グループ <elif グループ 群〉 く else グループ〉 endif 行 
if グループ： 

#//定数式改行くグループ〉 

# ifdef 进別名改行くグループ〉 

It ifndef 雄 別名改行くグループ〉 

elif グループ群： 
elif グループ 

elif グループ群 elif グループ 
elif グループ： 

# elif 定数式改行くグループ〉 

else グループ： 

#else 改行くグループ〉 
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endif 行： 

# endif 改行 


制御 行 

# include PP トークン改行 

# define »別名置換リスト改行 

# define 雄別名左 カツコ く雄別名リスト〉 ） 置換リスト 

It undef 雄別名改行 

Kline PP トークン改行 

# error <PP トークン〉改行 

# pragma <PP トークン〉改行 

# pragma warn アクション 短縮 fi 改行 

If pragma inline 改行 

# 改行 


アクション： 


短縮語： 


amb 

def 

amp 

dup 

apt 

eff 

aus 

mod 

big 

par 

cln 

pia 

cpt 

pro 


左カツコ： 

前にホワイトスぺ 


rch 

stu 

ret 

stv 

rng 

sus 

rpt 

ucp 

rvl 

c i 

use 

Slg 

str 

VUI 

zst 


スがついていない左カツコ 


置換リスト： 

く PP トークン群〉 


改行 


プリプロセッサ指令 
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PP トークン群： 

プリプロセッシングトークン 

PP トークン群プリプロセッシングトークン 

プリプロセッシングトークン： 

へッ ダ名 (# include 指令においてのみ） 

»別名 （キーヮードと重複しないもの） 

定数 

文字列リテラル 

演算子 

区切子 

各々は前にホワイトスペースがついていないもの 

ヘッダ名： 

< h 文字の並び〉 


A 文字の並び： 
h 文字 

み文字の並び h 文字 


A 文字： 

ソース記述文字セット中のすべての文字。ただし，改行文字と不等号 （>) は除く。 


改行： 

改行文字 
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8087/80287ステータスワード401 
8087/80287例外ハンドラ401 
_8087(グローバル変数> 26 
80 x 86 プロセッサ118 
—argc (グローバル変数）27 
argv (グローバル変数）27 
chmod (関数> 78 
— clear 87 (l 切数）82 
_close (間数）85 
一 control 87 (IMI 数）87 
_ creat(l 用数> 96 
doserrno (グロー八ル変数）30 
—emit 一一 (関数）116 
_exit (関数）124 
fmode (関数> 33 
jfpreset (関数）161 
graphfreemem (関数）560 
graphgetmem (関数）562 
heaplen (グロー八ル変数）34 
Jrotl (関数）259 
Jrotr (関数）260 
matherr (関数）268 
open (関数> 289 
osmajor (グローバル変数）36 
osminor (グロー八ル変数）36 
_psp (グロー八ル変数）36 
_read (関数) 332 
_rotl (関数> 339 
_rotr (関数）340 
status 87( 関数）401 


stklen (グローバル変数> 37 
_strerror (関数）410 
tolower (関数）441 
toupper (関数> 444 
version (グローバル変数）39 
write (関数）463 

【 A 】 

abort (関数> 43 
abs (関数）44 
absread (関数> 45 
abswrite (関数> 46 
accsess (関数）48 
acos (_ 数）50 

alloc.h 11 

allocmem (関数）51 

ANSI C 樣準7 

arc (関数> 505 

argc (main への引数）21 

ASCII 文字への変換52.441 

asctime (関数> 52 

asin (関数）54 

assert (関数）55 

assert.h 11 

atan (関数> 57 

atan 2( 関数）58 

atexit (関数）59 

atof (関数）61 

atoi (関数）63 

atol (関数）64 

【 B 】 

bar (関数）508 
bar 3 d (関数） 509 
bdos (関数） 66 


798 


索引 



bdosptr (関数） 68 
beep (関数） 65 
BGIOBJ ユーティリティ566 
bios 98 com (関数> 629 
bios 9800 m _ ch 2(関数）633 
bios 98 com _ ch 3( 関数）633 
bios 98 com_init (関数）634 
bios 98 com init ch 2( 関数）636 
bios 98 com _ init _ ch 3( 関数） 636 
bios 98 disk (関数 > 637 
bios 98 equip (関数 > 641 
bios 98 harddisk (関数） 643 
bios 98 key (関数） 646 
bios 98 memoryUHj 数） 649 
bios 98 mouse (間数） 650 
bios 98 mouse 」 nit ( IW 数 > 653 
bios 98 msw (関数） 656 
bios 98 print ( IH ] 数 > 658 
bios 98 stoptimer (関数） 661 
bios 98 time (関数） 662 
bios 98 timer (関数） 664 
bioscom (関数） 672 
biosdisk (関数） 675 
biosequip (関数） 641 
bios.h 11 

bioskey (関数） 681 
biosmemory (関数） 683 
biosprint (関数） 684 
biostime (関数） 685 
BIOS タイマ664,685 
BIOS 割り込み 
Oxll 679 
0 x 12 683 
0 x 13 675 
0 x 16 681 


0 x 17 684 
Oxl A 685 
brk (関数） 69 
bsearch (関数 > 70 
btom (関数 > 710 

【 C 】 

cabs (関数） 72 
calloc (関数 > 73 
ceil (関数 > 74 

CGA グラフイックスでの問題点505.583 

cgets (関数）75 

chdir (関数）77 

chkctype (関数）711 

chmod (関数）79 

chsize (関数）81 

circle ( 関数）510 

cleardevice (関数）511 

clearerr (関数）83 

clearviewport (間数）512 

clock (関数）84 

close (関数）86 

closegraph (関数）513 

clreol (関数）466 

clrscr (関数）467 

COMMAND.COM 434 

COMSPEC 環境変数434 

conio.h 11 

coreleft (関数）89 

cosh (関数）91 

cos (関数> 90 

country (関数）92 

CP 556.557 .558, 576 . 577 • 607 • 617,622 
移動579,580 
cprintf (関数）94 


索引 


799 




cputs (関数） 95 
creat (関数） 98 

creatnew (関数） 100 
creattemp (関数）101 
cscanf (関数） 103 
ctime (関数） 104 
ctrlbrk ( 関数 ）105 
ctype.h 11 

【 D 】 

daylight (グローバル変数） 28 
delay (関数） 107 
delline (関数） 468 
detectgraph (関数 > 514 
difftime (関数） 108 
directvideo (グローバル変数） 28 
dir.h 11 

disable (関数） 109 
div(_) 110 
DOS 

〜エラーコード 32 
〜 拡張 エラー 悄報 111 
〜環境 

〜からデータを返す 197 
〜にデータを追加する 320 
〜コマンド 434 

システム コール 66,68,214,332 
0x27 328 
0x28 329 
0x29 296 
0x33 186,359 
0x44 230 
0x48 51 
0x4E 148 
0x59 111 


0x62 204 

探索アルゴリズム121 
〜の設定 362 
〜を返す 197 

ディスク転送アドレス 149,150,329 
〜デバイスドライバ 231 
バージ ョ ン番号 36 
ハ•ス（ファイルの探索） 353 

〜フアンクシヨン 

0x19 196 
0x31 247 
メモリの解放 169 
割り込み 

0x21 224,226 
0x23 105,216 
0x24 213 
0x25 45 
0x26 46 

割り込みインターフェース 224,226 
割り込み関数 207,372 
割り込みハンドラ 105,213 
dosexterr (関数） 111 
dos.h 11 

dostounix (関数） 112 
drawpoly (関数） 519 
DTA 149,150.328 
〜の設定 362 
〜を返す 197 
dup (関数） 113 
dup2( 関数 > 114 

【 E 】 

ecvt (関数） 115 
ellipse (関数） 521 
enable (関数） 118 


800 


索引 



environ (グローバル変数） 22,29 

feof (関数） 139 

env(main への 引数） 21 

ferror (関数） 140 

eof (関数） 119 

fflush (関数） 141 

errno (グローバル変数） 30 

fgetchar (関数） 143 

errno.h 11 

fgetc (関数） 142 

exec ••.(関数） 120 

fgetpos (関数） 144 

exit (関数 > 125 

fgets (関数） 145 

exp (関数） 126 

【 F 】 

filelength (関数） 146 

fileno (関数） 147 

fillellipse (関数） 522 

fabs (関数） 127 

fillpoly (関数 > 523 

farcalloc (関数 > 128 

findfirst (関数） 148 

farcoreleft (関数 > 129 

findnext (関数） 150 

farfree (関数） 130 

float.h 11 

farmalloc (関数） 131 

floodfill (関数） 524 

farrealloc (関数） 133 

floor (関数） 151 

far ヒープ 

flushalU 関数） 152 

〜からのメモリ割り当て 128,130 

fmod (関数） 153 

〜の未使用メモリ请 129 

fnmerge (関数） 154 

〜メモリの解放 130 

fnsplit (関数） 156 

〜メモリの再割り当て 133 

fopen (関数） 158 

far ポインタ 

FP_OFF (関数） 160 

far ヒーブ上のブロ ッ ク への〜 

fprintf (関数） 162 

129.130,133 

FP_SEG (関数） 163 

〜のオフセッ ト値 283 

fputc (関数 > 164 

〜を返す 160 

fputchar (関数） 165 

〜の 作成 283 

fputs (関数） 166 

〜のセグメントアドレス 283 

fread (関数） 167 

〜を 返す 163 

freemem (関数） 169 

FCB 328,329 

free (関数） 168 

fcloseall (関数） 135 

freopen (関数） 170 

fclose (関数） 134 

frexp (関数） 172 

fcntl.h 11 

fscanf (関数 > 173 

fcvt(l 職） 136 

fseek (関数） 174 

fdopen (関数） 137 

fsetpos (関数） 176 


索弓 


801 



fsta “ 関数） 177 
ftell (関数） 179 
ftime (関数） 180 
fwrite (関数） 182 

【 G 】 

gcvt (関数） 183 
geninterrupt (関数） 184 
getarccoords (関数） 526 
getaspectratio (関数） 527 
getbkcolor (関数） 528 
getc (関数） 185 
getcbrk (関数） 186 
getch (関数） 187 
getchar (関数 > 188 
getche (関数） 189 
getcolor (関数） 529 
getcurdir (関数） 190 
getcwd (関数） 192 
getdate (関数 > 193 
getdefaultpalette (関数） 530 
getdfree (関数） 195 
getdisk (関数） 196 
getdrivername (関数） 531 
getdta (関数） 197 
get env (関数） 198 
getfat (関数） 200 
getfatd (関数） 201 
getfillpattern (関数） 532 
getfillsettings (関数） 533 
getfont (関数） 667 
getftime (関数） 202 
getgraphmode (関数） 535 
get image (関数） 536 
getlinesettings (関数） 538 


getmaxcolor (関数） 540 

getmaxmode (関数） 545 

getmaxx (関数） 546 

getmaxy (関数） 547 

getmodename (関数） 548 

getmoderange (関数） 549 

getpalette (関数） 550 

getpalettesize (関数） 551 

getpass (関数） 203 

getpixel (関数） 552 

getpsp (関数） 204 

gets (関数） 205 

gettext (関数） 469 

gettextinfo (関数） 472 

gettextsettings (関数） 553 

gettime (関数） 206 

getvect (関数 > 207 

getverify (関数） 209 

getviewsettings (関数） 555 

getw (関数） 210 

getx (関数） 556 

gety (関数） 557 

GMT 38.180.446 

gmtime (関数） 211 

goto (ノン ローカル〜） 106,257,364 

gotoxy (関数） 474 

graphdefaults (関数） 558 

grapherrormsg (関数） 559 

graphics.h 11 

graphresult (関数） 563 

【 H 】 

hantozen (関数） 712 
harderr (関数） 213 
hardresume (関数） 216 
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hardretn (関数）217 

isalnmkana (関数）713 

high video (関数）475 

isalnum (関数）232 

hypot (関数） 218 

【 I 】 

isalpha (関数）233 

isascii (関数）234 

isatty (関数）235 

imagesize (関数） 565 

iscntrl (関数）236 

initgraph (関数） 566 

isdigit (関数）237 

inport (閲数） 219 

isgraph (関数）238 

inportb (関数）220 

isgrkana (関数）714 

insline (関数）476 

iskana ; 関数）714 

installuserdriver (関数> 572 

iskanji 2( 関数）715 

installuserfont (関数）575 

iskanji (関数）715 

int 86( 関数）221 

iskmoji (関数）716 

int 86 x ( 関数）223 

iskpun (関数）716 

intdos _ 数）224 

islower (関数）239 

intdosx (関数）226 

ispnkana (関数> 717 

intr (関数）228 

isprint (関数> 240 

I/O 

isprkana (開数）717 

画面〜94,318 

ispunct (関数）241 

グラフィックス〜594.622 

isspace (関数）242 

コンソール〜 103,155,156 

isupper (関数）243 

ストリーム137.142 .158.162.164. 166, 

isxdigit (関数）244 

167,173.182,185, 188,205.210,305, 

317,320 .321. 322, 342. 357, 369.401. 

402,404,457,458,459,460,461 

itoa (関数）245 

【 J 】 

ディスク〜637,675 

jasctime (関数> 718 

ファイル〜141，146.162.164,166,167 • 

jctime (関数）719 

173,182,185,210,332,333,369, 

jisalpha (関数）720 

457,458.463 

jisdigit (関数）720 

〜ポート629.672,219, 220. 294 

jishira (関数）721 

文字列75,94,145,166,203,295,296, 

jiskana (関数）722 

321,395 .398, 461 

jiskata (関数> 723 

ioctl (関数）230 

jiskigou (関数）724 

io.h 11 

jislO (関数）724 

isalkana (関数）713 

jisll (関数）725 
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jisl2( 関数） 726 
jislower (関数） 727 
jisspace (関数） 727 
jistojms (関数） 728 
jisupper (関数） 729 
jiszen (関数） 729 

JIS コードを 

シフト JIS コードに変換する 728 
JIS 第 1 水準漢字を判定する 725 
JIS 第 2 水準漢字を判定する 726 
jmstojis (関数） 730 
jstradv (関数） 731 
jstrchr (関数） 732 
jstrcmp (関数） 733 
jstrlen (関数） 734 
jstrmatch (関数） 735 
jstrncat (関数） 736 
jstrncmp (関数〉 737 
jstrncpy (関数） 738 
jstrrchr (関数） 739 
jstrrev (関数） 740 
jstrskip (関数） 741 
jstrstr (関数） 742 
jstrtok (関数） 742 
jtohira (関数） 743 
jtokana (関数） 744 
jtokata (関数） 745 
jtolower (関数） 746 
jtoupper (関数） 747 

【 K 】 

kbhit (関数） 246 
keep (関数） 247 


【 L 】 

labs (関数） 248 
ldexp (関数） 249 
ldiv (関数） 250 
lfind (関数） 251 
limits.h 11 
linerel (関数） 577 
lineto (関数） 578 
line (関数） 576 
localtime (関数） 252 
lock (関数） 254 
loglO (関数） 256 
log (関数） 255 
long int の変換 265,448 
longjmp (関数） 257 
lowvideo (関数） 477 
lsearch (関数） 261 
lseek (関数） 263 
ltoa (関数） 265 

【 M 】 

main (関数） 21 

C 型と宣言する 25 
Pascal 呼び出し慣例でのコンパイル 
25 

コマンドライン引数 24 
ワイルド カー ドの展開 24 
〜の戻り値 25 
〜-^渡す引数21 
〜の宣言22 
例 22,23 
malloc (関数） 266 
matherr (関数） 270 
math.h 12 
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max ( 関数 ） 273 
mc—block ( 関数 ） 691 
mc continue ( 関数 ） 694 
mc_ground ( 関数 ） 695 
mc initialize ( 関数 ） 696 
mc inquire ( 関数 ） 697 
mc—mode ( 関数 > 699 
mc play ( 関数 ） 700 
me register ( 関数 ） 702 
mc rom ( 関数 ） 704 
mc_scalar ( 関数 ） 705 
me—stop ( 関数 ） 707 
memccpy ( 関数 > 274 
memchr ( 関数 ） 275 
mememp ( 関数 ） 276 


normvideo ( 関数 ） 479 
nosound ( 関数 ） 288 
nthetype ( 関数 > 749 

【0】 

open ( 関数 ） 291 
outport ( 関数 ） 294 
outportb ( 関数 ） 295 
outtext ( 関数 ） 581 
outtextxy ( 関数 ） 582 

【 P 】 

parsfnm ( 関数 ） 296 
Pascal の呼び出し慣例で 

main をコンバイルする 25 


memepy ( 関数 ）277 

PATH 環境変数 120,389 

mem.h 12 

PC のスピーカ 288,389 

memiemp ( 関数 ）278 

peekb ( 関数 ）298 

memmove ( 関数 ）279 

peek ( 関数 ）297 

memset ( 関数 ）280 

perror ( 関数） 30,299 

min ( 関数 ）281 

pieslice ( 関数 ）583 

mkdir ( 関数 ）282 

pokeb ( 関数 ）301 

MK_FP ( 関数 ）283 

poke ( 関数 ）300 

mktemp ( 関数 ）284 

poly ( 関数 ）302 

MML 689 

powlO ( 関数 ）304 

modf ( 関数 ）285 

pow ( 関数 ）303 

movedata ( 関数 ）286 

printf ( 関数 ）305 

moverel ( 関数 ）579 

process.h 12 

movetext ( 関数 ）478 

PSP 36,204 

moveto ( 関数 ）580 

putchar ( 関数 ）319 

movmem ( 関数 ）287 

putch(functioln) 318 

mtob ( 関数 ）748 

putc ( 関数 ）317 

【 N 】 

NMI 割り込み 110 

putenv ( 関数 ） 320 

putimage ( 関数 ） 585 

putpixel ( 関数 ） 587 
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puts (関数） 312 
puttext (関数） 480 
putuserfont (関数） 670 
putw (関数） 322 

【 Q 】 

qsort (関数） 323 

【 R 】 

raise (関数） 325 
RAM 

常駐ブログラム 247 
〜のサイズを返す683 
未使用の〜の { ft を返す89 
randbrd (関数）328 
randbwr (関数）329 
random (_ 数）330 
randomize (閲数）331 
rand (関数）327 
read (閲数）333 
realloc (関数）334 
rectangle (関数）588 
registerbgidriver (関数）589 
registerbgifont (関数）591 
REGPACK 構造体228 
remove (関数）335 
rename (関数）336 
restorecrtmode (関数）592 
rewind (関数）337 
rmdir (関数）338 

ROM のフォントパターンの 読み出し667 
RS -232 C の 制御629,634 
RS -232 C コミュニケーション 672 


【 S 】 

sbrk (関数> 341 
scanf (関数）342 
searchpath (関数）353 
sector (関数> 593 
segread (関数）593 
setactivepage (関数）594 
setallpalette (関数）595 
setaspectratio (関数）597 
setbkcolor (関数）598 
setblock (関数）356 
setbuf (関数）357 
setcbrk (関数）359 
setcolor (関数> 600 
setdate (関数> 360 
setdisk (関数）361 
setdta (関数）362 
setfillpattern (関数）602 
setfillstyle (関数）603 
setftime (関数）363 
setgraphbufsize (関数）605 
setgraphmode (関数）607 
setjmp (関数）364 
setjmp.h 12 
setlinestyle (関数）608 
setmem (関数）366 
setmode (関数）367 
setnewdriver (関数）610 
setpalette (関数）611 
settextjustify (関数）617 
settextsyle (関数）617 
settime (関数）368 
setusercharsize (関数）620 
setvbuf (関数）369 
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setvect (関数） 372 

setverify (関数 > 373 

setviewport (関数） 622 

setvisualpage (関数） 623 

setwritemode (関数） 624 

share.h 12 

signal.h 12 

signal (関数） 374 

sin (関数） 381 

sinh (関数) 382 

sleep (関数） 383 

sopen (関数） 384 

sound (関数) 389.387 

spawn .••(関数） 390 

sprintf (関数） 395 

sqrt (関数） 396 

srand (関数） 397 

sscanf (関数） 398 

stat (関数） 399 

stat 構造体 177,399 

stdargs.h 12 

stdaux 135 

stddef.h 12 

stderr 12,135 .141 

stdin 12,135 ,143,170.205,342,460 

stdio.h 12 

stdlib.h 12 

stdout 12,135 ,165,170.305,319,321,459 

stdprn 12,135 

stime (関数） 402 

stpcpy (関数） 403 

strcat (関数） 402 

strcmp (関数） 407 

strcmpi (関数） 406 

strcpy (関数） 407 


strcspn (関数） 408 

strdup (関数） 409 

strerror (関数） 411 

stricmp (関数） 415 

string.h 12 

strlen (関数 413 

strlwr (関数） 413 

strncat (関数） 414 

strncmp (関数） 415 

strncmpi (関数） 416 

strncpy (関数） 417 

strnicmp (関数） 418 

stmset (関数） 419 

strpbrk ( 関数） 420 

strrchr (関数 > 421 

strrev (関数） 421 

strsetdW 数） 422 

strspn (関数） 423 

strstr (関数） 424 

strtod (関数 > 425 

strtok (関数） 427 

strtol (関数） 429 

strtoul (関数） 431 

strupr (関数） 432 

swab (関数） 433 

sys errlist (グローバル変数） 30 

sys nerr ( グローバル変数 ） 30 

sys¥stat.h 12 

system (関数） 434 

sys¥timeb.h 12 

sys¥types.h 12 

【 T 】 

tan (関数） 435 
tanh (関数） 436 
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tell (関数） 437 
textattr (関数） 481,484 
textbackground (関数） 484 
textbank (関数） 488 
textblink (関数） 486 
textcolor (関数） 490.492 
textcursor (関数） 494 
textheight (関数） 625 
textmode (関数） 495.497 
text reverse (関数） 499 
textunder (関数） 500 
textvertial (関数） 501 
textwidth (関数） 626 
time (関数） 438 

time.h 12 

timezone (グローハ•ル変数） 38 
tmpfile (関数） 439 
tmpnam (関数） 440 
toascii (関数） 441 
tolower (関数 > 443 
toupper (関数） 445 
TSR ブログラム 247 
Turbo C の言語の構文 
演箅子 782 
外部定義 792 
キーワード 776 
区切子 782 

語意に関する文法 777 
式 783 
識別名 777 
宣言 783 
定数 777 
トークン 776 

プリプロセッサ指令 775,793 
フレーズに関する文法 775.781 


文 791 

文字列リテラル 781 
tzname (グローバル変数） 38 
tzset (関数） 449 

【 U 】 

ultoa (関数） 448 
ungetc (関数） 449 
ungetch (関数） 450 
unixtodos (関数） 451 
UNIX 形式への変換 112 
unlink (関数） 452 
unlock (関数） 453 

【 V 】 

values.h 12 
va. ••(関数） 454 
vfprintf (関数） 459 
vfscanf (関数> 462 
vprintf (関数） 457 
vscanf (関数） 460 
vsprintf (関数） 461 
vsscanf (関数） 462 

【 w 】 

wherex (関数） 502 
wherey (関数） 503 
WILDARGS.OBJ 23 
window (関数） 504 

【 X 】 

x アスぺクト因子 527 
x 座標 556 

〜の最大値 546 
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【 Y 】 

y アスべクト因子527 
y 座標557 

〜の最大値547 

【 z 】 

zentohan (関数）750 

【ぁ】 

アークコサイン50 
アークサイン54 
アークタンジェント57 
アクセス 

〜フラグ384 
〜モード399 
〜の変更78.79 
統み出し/丼き込み 

48.79.98.99.178.291.292.400 
アクティブベージ594 
アスペクト比527,597 
補正因子597 

アドレス 

emit — J こ渡す116 
余り110.153.250 
一時停止(実行の〜）107,383 
色 

テキストハへ y クグラウンド色の 

設定484,481,486 
文字の〜の設定484,481,492,490 

インクルードファイル11 
インターバルタイマの制御661,664 
ウィンドウ 

テキストモード〜の定義504 
英句読点 • カナ句読点をする717 


英数字 • カナ文字を判定する713 
英文字 • カナ文字を判定する713 
エコー（画面への〜） 189 
ェラー 

拡張 DOS 〜情報111 
〜コード 30 

グラフィックスを返す563 
ニーモニック 11,31,32 
コマンドライン751 
ストリーム上の〜の検出140 
致命的な〜 （ Fatal ) 752 
ディスクアクセス〜751 
〜メッセージ 30.753 -768 

グラフ ィッ クス〜を返す559,563 
コンパイラ751 
システム〜299 
致命的な752 

〜へのポインタを返す409,410 
メモリアクセス751 
read/write 140 

エラーハンドラ 

ハードウヱア〜 213,216 
浮動小数点〜268 
ユーザが変更できる数学〜270 
演筇子782 

演奏状況を調べる697 
演奏する700 
演奏の再開694 
演奏の中断707 
演奏モードの切り換695 
扇形583 
惰円の〜593 

オフセット （ far ポインタの〜）160,283 
親プロセス120,390 
音色データの設定/読み出し691 
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音色データバンクの再設定 704 

【か】 

カーソル（テキストウインドウ中の〜) 
〜位逋を返す502,503 
〜を位 1 K づける474 
カーソル属性のセット494 
開始点（乱数発生の〜）397 
外部定義792 
回復(画面の〜）480 
冉き込みアクセス 48,79,98,101. 

178,292,400 
冉き込みエラー140 
拡張エラー情報111 
仮数部172 

下線«性のセット499 
可能にする（割り込み）118 
可搬性42 

可変引数リスト list 454 
阑面 

I / O 〜 I/O 95.318 
座標の煅大値546,547 
〜上のテキストのセーブ480 
〜の回復592 
〜のクリア467.607 
〜へのエコー189 
〜モードの回復592 
画面ページの切り換え488 
カラー 

ドロウ〜529,558,583,588,593 
〜の設定600 
〜の最大値545 


〜の悄報を返す533 
〜の設定603 

カラーテーブル（パレット）595,611 

環境 

DOS 〜 

〜からデータを返す198 
〜へデータを追加する320 
〜変数29 
COMSPEC 434 
PATH 121,391 

潢字オプション（コマンドライン）709 
漢字第1バィトを判定する715 
潢字第2バイトを判定する715 
潢字対応版 

jisalpha ( isaplha ) 720 
jisdigit ( isdigit ) 720 
jislower ( islower ) 727 
jisspace ( isspace ) ill 
jisupper ( isupper ) 729 
jstrlen ( strlen ) 734 
jstrmatch ( strpbrk ) 735 
jstrncat ( strncat ) 736 
jstrncmp ( strncmp ) 737 
jstrncpy ( strncpy ) 738 
jstrrchr ( strrchr ) 739 
jstrrev ( strrev ) 740 
jstrstr ( strstr ) 742 
jstrtok ( strtok ) 742 
キーストロークのチェック246 
キーボードインターフェース 646 
キーボード操作681 
疑似乱数327 


background 528,558 輝度 

〜の設定598 高〜475 

フィル508,509,522,524,583,593 低〜477 
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標準〜 479 
逆正弦54 
逆正接57 
逆余弦50 

キャリーフラグ221,223 .224, 226 
行 

空白〜の揷人476 
〜の削除468 
行末までクリア466 
許可（アクセス〜）79.400 
结止する（割り込み）109 
クイックソートアルゴリズム323 
区切子782 
[玉 I 別データ92 
グラフィックス 

〜 I/O 594.622 
〜アダプタ514 

バッファ 

内部バッファ605 
〜エラーコードを返す563 
〜エラー•メッセージ563 
〜画面のクリア511 
システム 

〜のクローズ513 
〜の初期化566 
〜悄報を返す553 
テキストフォント558 
デフォルトの設定558 
〜ドライバ514.566 
〜コード589 
〜ファイル566 
〜モードの範囲549 

メモリ 

〜の解放560 
〜の割り当て562 


モード514.566,592,607 

画面操作モードも参照 
カレント〜を返す535 
〜の名前548 
〜ルーチン14 
クリア 

圃面467 
行末まで466 

グリニッジ標準時38,108,180,211,446 
グローバル時刻変数のセット446 
グローバル変数26 

—8087 26 
argc 27 
argv 27 
daylight 28 
directvideo 28 
doserrno 30 
environ 29 
errno 30 
fmode 33 
heaplen 34 
osmajor 36 
osminor 36 
_psp 36 
stklen 37 
sys errlist 30 
sys nerr 30 
timezone 38 
tzname 38 
version 39 
菁告 769-774 

現在位； S ( グラフィックス）556,557 ,558, 

576,577 ,578,592,617.622 
〜の移動579,580 
検索キー261 
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検出 


サイン381 


グラフィックスアダプタ514,566 
ストリーム上のエラー140 
高輝度475 

〜ビッ トのセット475 
構文(軎式） 

エラー 751 
コサイン90 

ハイハ •ボリ ック〜 91 
子ブロセス120,390 
コプロセッサ （8087/80287) 

浮動小数点での問題点161 
コマンドライン 

エラー751 
コルーチン257,364 
コンソール I / O 103,188,189 

コント ロールブレーク 
リターン186 
設定359 
ハンドラ105 
割り込み216 
コンバイラ 

診断メッセージ751 
サードハ•ーティ提供の 

デハ•イスドライバ572 

【さ】 

サイズ 

パレット〜を 返す551 
ファイル〜の変換81 
文字の〜617 
最大値（カラー値の）540 
再割り当て（メモリの〜） 

ヒープ 334 
far ヒープ 133 


ハイパボリック〜382 
サウンド LSI 内のレジスタ操作702 
サウンドライブラリ 
作業ディレクトリ121,391 
〜の変更77,78 
〜を返す190,191 

削除 

行468 
ファイル452 

座標 

arc での〜を返す526 
画面〜の煅大値546.547 
サフィックス（接頭辞） 
exec ." 120 
spawn …390 

シーケンシャルレコード251 
終了コード43 
終了時関数59 
終了ステータス125.247 
時間 

〜の計算84,108 
〜を返す84,438 
経過〜 

システム時刻52,104,112,180, 

211,252,451,662 

〜を返す206 
〜をセットする368,402 
ファイル時刻202,363 
式780 
識別名775 

シグナルハンドラ325,374 -379 
ソフトウェア〜325 
ユーザ定義の〜374 
指数172 
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指数関数 126 
システム 

〜時刻52,104,112,180， 

211.252.451.662 
〜を返す206 

〜をセットする368,402 
〜日付52,104,112，180, 

211.252 .451. 662 
〜を 返す193 

〜をセットする360.402 
システム悄報を得る641 
システム日付時刻の読み出しと設定662 
自然対数255 
実行環境の初期化 

(サウンドライブラリ）696 
実行の一時停止107.383 
自動検出566,572 
シフト JIS コード中の 

漢字以外の文字を判定する724 
シフト JIS コードを 

JIS コードに変換する730 
斜辺475 
終了 

〜時関数59 

ブログラムの〜 124,125 
商110 
乗 

10の p 乗304 
x の y 乗303 
剰余153 
常用対数255 
除荪(整数）110 
long 250 

書式設定94,103,162,173,305,342,343, 
395,398 .458, 459 ,460.461.462.463 


型指定文字345 
精度指定子 306-311 
代入抑制文字344,349,350 
入カサイズ修飾子 305-316 
幅指定子311,344,349,350 
引数型修飾子344 
フラグ文字306,309 
交替形式310 
変換指定文字307,308 
変換できない文字350 
ポインタサイズ指定子344,349 
害式文字列94,103 .162.173.305.342.343. 
395 .398.458.459• 460 • 461 • 462,463 
憤例346 
探索粜合347 
人カ フィールド 346 
範囲機能348 
シリアル I/O 629,672 
診断メッセージ（コンバイラ） 

数学エラーハンドラ 

(ユーザが変更可能な〜）270 
数学パッケージ（浮動小数点）161 
スタイル（フイル）558 
スタック 73.89.226 
〜の 長さ37 

〜ボインタ pointer 257,364 
ステータスバイト 637,677 
ステータスビット 629,673 
ステータスワード 

8087/80287 82,401 
浮動小数点82,401 
ストッブビット629.673 

ストリーム 

〜 I / O 134，139，158，162，164 • 166，167, 
173,182,185,188,205,210,305, 
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317,319 ,321,322,342,357,369, 
457,458 ,459,462 
入力〜へ文字を 

ブッシュバックする395 
〜のオーブン158,170 
〜の3£き換え170 
〜の クローズ 134,170 
〜のフラッシュ140.152 
バッファリングされない〜357.369 
バッファリングされる〜357.369 
ファイルハンドルを結ひ•つける137 
ストロークフォント575.620 
リンクされた〜591 
スピーカ （IBM PC の）288,389 
スペース以外の半角文字を判定する714 
図形のフィル524 
制御ワード（浮動小数点 ） 87 
桉数 

除算110 
long 250 

ストリームからの桄み込み210 
ストリームからの辦き込み322 
変換245 
正接435 

双曲線〜436 
精度(浮動小数点 ） 87 
セーブ(画面上の）テキストの〜469 
セクタ（デイスク）45,46 
セグメント値 （ far ポインタ）163,283 
絶対値 

long 整数の〜248 
整数の〜44 
複素数の〜72 
浮動小数点の〜127 
設定項目メニュー設定項目を参照 


全角文字 

〜大文字を英小文字に変換する746 
〜英大文字を判定する729 
英小文字を英大文字に変換する747 
〜英小文字を判定する727 
〜英文字を判定する720 
カタカ十をひらがなに変換する743 
〜カタカナを判定する722,723 
〜旬統点を判定する724 
〜数字を判定する720 
〜スペースを判定する727 
ひらがなをカタカナに変換する 
744.745 

〜ひらがなかを判定する721 
〜文字を判定する729 
〜文字を半角文字に変換する750 
宣言786 
練形探索251,261 
双曲線正弦382 
双曲線正接436 
双曲線余弦91 

ソースコード（ランタイムライブラリ〜 ）10 
ソート（クイック）323 
属性（テキスト) 481,484 
属性ビット96.101 .291 
属性ワード 78.96,101 

ソフトウェア 

〜シグナル325 
〜割り込み184,221,223,228 

〜インターフェース 221,223,228 

【た】 

対数 

自然〜255 
常用〜256 
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楕円 521 
搰円弧521 
惰円の扇形593 
多角形519,523 
多項式302 
タスクの状態257 
縦線域性のセット501 
探索 

DOS の PATH によるファイル〜 
353 

〜アルゴリズム （ DOS ) 120 
線形251.261 

八 イナリサーチ（二分探索）70 
ブロック中の文字の〜275 
文字列中の〜 

トークン〜 247.742 
文字〜362,404,732 

探索して追加する261 
タンジェン ト435 

ハイパボリック〜436 
チェック 

カレントドライバ196 
キーストローク 246 
デバイスタイプ235 
ファイルエンド105,139,332 
致命的ェラー751 
〜メ ッ セージ 752 

チャンネル3に対するモード指定699 
長方形588 
通《記号93 
低輝度477 
定数777 

ディスク 

BIOS に送られる操作637,675 
〜 I/O 637,643.675 


〜エラー 213 
アクセス751 

害き込みのベリファイ209,373 
〜スペースを直す195 
〜セクタ45,46,637,675 
〜ディレクトリの探索148,150 
〜ドライブの設定361 
ディスク装 S の操作637,643 
ディスク転送アドレス149,150,328 
〜の設定362 
〜を 返す197 
ディレクトリ 

〜の削除338 
〜の作成282 
作業〜391 

〜の変史 • 77 
〜を返す190,192 
ディスクの探索148,150 
データセグメント34,73,89,266 
割り当て69 
〜の変更341 
データビット672 
テキスト 

位 S 合わせ617 
〜の «性481.484 

〜のコビー 

W 面上の長方形領域を 
他の場所へ478 
画面へ480 
メモリへ469 

バックグラウンド色481,484,486 
〜フォント（グラフィックス）558,617 
〜情報を返す553 

モード33,98，101，137,158，170,333, 
367,469,480,495,497,607, 
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画面操作モードも参照 
〜ウィンドウの定義504 
〜を返す472 
テキスト厲性 

下線厲性のセット500 
縦線域性のセット501 
点滅属性のセット489 
反転厲性のセット499 

デバイス 

〜エラー 213 
型チェック235 
キャラクタ〜235 
〜チャネル230 
〜ドライ/く 

DOS 〜230 

サードバーティ提供の〜572 
〜ドライ 八 テーブル 572 
デバッギングマクロ （ assert ) 55 
デフォルトの設定558 
点滅域性のセット489 
動的メモリ割り当て73.168 .266, 334 
トークン776 

文字列の〜の探索427,742 
ドライブ（カレント〜名）196 
ドライブ番号531 

ドロウカラー 529,558,583,588,593 
〜の設定359 

【な】 

内部 グラフィックス八ッファ 605 
ニーモニック（エラーコード） 11,30 .32 
二分探索70 
日本語対応版 

jasctime ( asctime ) 718 
jctime ( ctime ) 719 


人カフィールド 

スキャンされない〜351 
スキャンされるが格納されない〜351 
ノン ローカル goto 257,364 

【は】 

バー 

2次元〜508 
3次元〜509 

ハー ドウェア 

エラーハンドラ213,217 
〜悄報を返す679 
〜ボート219.220.294 
〜割リ込み118 
倍艮按数の変換265.448 

バイト 

入れ替え433 
コピー 286 

ハードウヱアボートからの読み込み 
220 

ハードウェアポートへの搿き出し295 
ハ•イナリサーチ70 

バイナリモード33,98,137,158,170,367 
ハイバボリックタンジェント436 
パヶット構造体 
バスの組み立て154 
パスの分割156 
パスワード203 

バターン（フイル〜） 508,509,522,524, 

558,583,593 

〜に関する情報を返す533 
〜の設定603 
ユーザ 定義の〜532.603 
八ッ カス • ナウア記法775 
バッ クグラウンド カラー 528,558 
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〜の設定 598 

バッファ 

キーボード〜への 

文字のブッシュ八ック 450 
グラフィックス内部〜605 
出カストリームへの害き出し152 

スト リームクロース •時の 

〜のフラッシュ134 
〜の解放134 
〜のクリア152 

バッファリング 

ストリーム357.369 
ファイル369 

バッファリングされないストリーム 

357,369 

バッファリングされるストリーム357.369 
バラメータデータの設定/挽み出し705 
バリティ629,672 
パレット558.566 .598. 607 

〜カラーテーブル 595.598.611 
〜カラーの変更 595,611 
〜サイズを返す551 
〜悄報を返す530.550 
〜定我構造体530 
デフォルト〜530 
ユーザ定義の〜 

IBM 8514 615 
PC -9801 613 
範囲機能348 
半角文字 

カナ句読点を判定する716 
カナコ ー ドを判定する714 
カナ文字を判定する716 
全角文字に変換する712 
〜を判定する717 


反転厲性のセット499 
ハンドラ374 

エラー-- 213,216,217,268,270 
シグナル〜 325,374,379 
ユーザー定義の〜374 
例外〜82 
割り込み〜376 

ハンドル 

ストリームに結ひ•つける137 
〜の複製113,114 
〜を返す147 

ハンドル（フアイル〜） 

85,86, 113,114.293 
ヒープ 89 

〜上のメモリ割り当て 
73,168,266.334 
〜の長さ34 
〜メモリの解放168 
〜メモリの再割り当て334 
ヒープ ( far ) 

〜上のメモリ割り当て128,131 
〜中の未使用メモリ129 
〜メモリの解放130 
〜メモリの再割り当て133 
比較関数(ユーザ定義）323 
ピクセルカラー 

〜のブロット 587 
〜を 返す552 

日付 

〜を設定する360,402 
システムの〜 52,104,112,180, 

211,252,451 

〜を返す193 
ファイルの〜 202,363 
日付•時刻の変換52,104,112,211，252,451 
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ビットイメージ 

格納の必要なメモリ565 
画面への害き出し585 
メモリへの保存536 

ビッ トの口ーテート 

long 型格数260 
符号なし整数339,340 
ビットマスク177,399 
ビデオ悄報（テキストモード）472 
ビューポート 

グラフィックス出力用に〜を設定する 
622 

〜に関する情報を返す555 
〜へ文字列を表示する581,582 

標識 

エラー〜83 
ファイル終了〜83 

ファイル 

I/O 85.142, 145，162.164,166,167. 
173,182.332,333,357.457,460. 
463,556 

アクセス（読み込み/斟き込み） 
48,79.98.101,177,291.399 
ァクセス権の決定48 
〜からの統み込み332,333 
グラフィックスドライバ〜566 
更新用〜138.158.172 

〜コントロールブロック （ FCB ) 

328,329 

〜サイズ 

〜の変更81 
〜を返す146 
〜時刻202,363 
スクラッチ439 
•〜属性78,79,%,291 


〜属性ビット96,101,291 
〜属性ワード78,96 • 101 

〜にフアイルハンドルを 

結びつける137 
〜の新たな作成96,98,100,101 
〜の上害き98 

〜のオーブン 158.169,289,291 
〜の SK き換え170 
〜の齊きなおし96,98 
〜の クローズ 85.134 .135 
〜の 削除335.452 
〜の悄報を返す177.399 
〜のバッファリング 369 
〜の H 付•時刻202,363 
〜の 変換33 
バイナリ〜 439 
〜ポインタ 

〜の 初期化337 
〜のセット 176,291 
統み込み/洱き込み263 
リセット 174,333 
〜を 返す144.179.437 

〜名 

〜の 解析296 

ユニークな〜を作る 284,440 
〜をつくる 154 
〜の変更 336 

ファイルアクセス 許可79,399 
フアイルアロケーシヨンテーブル200 

ファイルエンドを調べる 119,139,333 
ファイルシェア 453 
〜属性289 
〜のロック 254.453 
ファイルハンドル 85,113,114,291 
〜を 返す147 
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〜の複製113，114 
〜をストリームに結び付ける137 
フイルカラー508,509,523,524,583,600 
〜悄報を返す533 
〜の設定603 
フイル（図形の〜）524 
フイルスタイル558 
フィルパターン508,509.523, 524. 

558.583,600 
〜悄報を返す533 
定推済みの〜533 
〜の設定603 

ユーザ定我の〜532.533 .602. 603 

フォント 

ストローク〜575,617,620 
ビットマッブ〜617 
リンクされた〜591 
浮動小数点 

エラー処理268 
〜数学パッケージ161 
〜ステータス82 
〜制御ワード87 
〜の変史114，136,183 
〜例外87 

浮動小数点ステータスワード401 
フラグ 

アクセス〜385 
読み込み/冉き込み384 
フラッシュ（ストリームの〜）141152 
プリプロセッサ指令541,552 
ブリンク指定ビット481,484 
プリンタ制御関数658,684 
プリンタの制御658 
ブレーク値69,341 

フレーズの_造に関する文法775,780 


フレームベースポインタ256,364 
プログラムセグメントプレフィクス 

36,204 

ブログラムの終了124,125 

ブロック 

コピー274.277.279 287 
〜サイズの調整356 

far ヒープ上の〜133 
ヒープ上の〜334 
〜初期化280.367 
〜文字の探索275 
プロトタイプ41 
文551 

分割（バス名の）156 
文法 (Turbo C の構文）775 
平方根396 

ページ（アクテイブ〜 ） 594 
ページ番号（ビジュアル〜> 623 
8086 の〜 207,372 
〜のセット372 
〜を返す207 

ベクター（割り込み〜）105 
へッダフアイル41 

ベリファイフラグ（デイスク冉き込みの〜) 

209,373 

変換 

ASCII 文字へ52,441 
double を仮数部と指数部に172 
double を格数と小数点以下に285 
long を文字列に265 
unsigned long を文字列に448 
大文字を小文字に413,442,443 
小文字を大文字に432.444,445, 

746,747 
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整数を文字列に 265 
全角文字を半角文字に 750 
半角文字を全角文字に 712 
日付-時刻 52,104.718.719 
DOS 形式へ 451 
UNIX 形式へ 112 

グリニッジ標準時へ211 

構造体へ 252 

浮動小数点を文字列に 115,136.183 
文字列の〜 

double へ 425 
long 型整数へ 64,429 
unsigned long へ 429 
整数へ 63 
浮動小数点へ 61 
変換モード 98,99 
変数 

グローバル 〜26 
グローバル時刻の 〜446 
ポート I/O 219.220 .294, 295, 629. 672 
ボーレート 629.672 
補正因子 597 

【ま】 

マウスの制御 650.653 
マシン語命令を 

オブジェクトコードへ揷入する 116 

丸め 

切り上げ 74 
切り捨て 87 

丸めのモード（浮動小数点 ） 87 
未使用領域を返す（ディスクの〜） 195 
無限大(浮動小数点 ） 87 

メモリ 

far ヒープ〜の再割り当て 133 


〜アクセスエラー 751 
画面領域を〜にコピーする 180 
グラフイックスライブラリでの 
〜管理 560.562 
指定の〜アドレス 

〜からバイトを返す 298 
〜からワードを返す 297 
〜に整数を格納する 300 
〜にバイトを格納する 301 
〜の解放 

DOS メモリ上の〜 169 
far ヒープ上の〜 130 
グラフィックス〜 560 
スモール • ミディアム 

メモリモデルでの〜 130 
〜のコピー 274,277,279,287 

スモール • ミディアム 

メモリモデルでの〜 286 
〜の初期化 280 
ヒープ〜の再割り当て 334 
ビットイメージを〜にセーブする 536 
未使用の〜の S を返す 89 
far ヒープ上の〜 129 
〜モデル 7 
〜割り当て 51 

far ヒープ 128.131 
グラフ イッ クス〜 562 
データセグメント 69 
データセグメント上の 
〜の変更 341 
動的〜 73,168,266,334 
ヒープ 73,168,266,334 

モード 

アクセス〜 399 
〜の変更 78,79 
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画面モードの回復592 
カレントグラフィックス〜535 
カレントドライバでの〜の最大値545 
グラフィックス〜514,566 .592, 607 

グラフィックスドライバにおける 
〜の範囲549 

テキスト〜33,98,101,137,158,171, 
318 . 333 • 367,469,472 • 495 • 607 
〜の名前548 
パイナ、）〜 

33,98,101.137.158.170,367 
ファイル変換98.101 

文字 

色の指定481.490 
大文字への変換444,445 
冉き出し 

stdout へ165,319 
スクリーンへ318 
ストリームへ162.317 
拡大(ユーザ定義> 620 
キャラクタデハ•イス235 
小文字への変換442,443 
〜サイズ617 
〜の探索 

ブロック中275 
文字列中404 
〜の読み込み 

stdin から143,188 
コンソールから187 
ストリームから142,185 
ブッシュバック 

キーボードバッファへ450 
入カストリームへ449 
文字数を調べる710,734 
文字タイプを調べる711,749 


文字列 

〜 I/O 75,95.143,165,205， 

294,295,321,395,398 
大文字に変換する432 
逆順にする421 
小文字への変換413 
〜のコピー403,407,409,417 
〜の初期化419.422 
〜の萵さを返す625 
〜の探索 

トークン427,742 
文字404,732 
〜の追加403.414 
〜の長さの計算413 
〜の幅を返す626 
〜のバイト数を調べる748 
〜の比較276.405,412, 733. 737 
文字ケースの無視 

278,406,412,416,418 
〜の変換 61.63.64,425,429.431 
日付時刻〜104.719 
〜ポインタを移動させる731 
〜リテラル781 
をし〜を調べる 
最後の文字421 
集合中にない文字408,741 
集合中の文字 for 420 
集合中の文字からなる部分423 
部分文字列424 
文字列 I/O 461 

モノクロアダプタでの 

グラフィックスの問題点505,583 

【や】 

ユーザが変更できる 
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数学エラニハンドラ 270 リンクされたフォント591 

ユーザがロー ドした 例外(浮動小数点 ） 87 

グラフィックスドライバ589 例外ハンドラ （8087/80287) 82.401 

ユーザ指定のシグナルハンドラ375 レジスタ変数257,364 


ユーザ定義の比較関数284,323 
ユーザ定義のフィルパターン532.602.603 
ユーザ定義文字の設定670 
余弦90 

双曲線〜91 
読み込みアクセス 

48,79,98，101,178,291,400 
統み出しエラー140 
統み出し/辨き込みフラグ384 

【ら】 

ライブラリ 

〜ファイル7 

〜リファレンスのサンブル41 
ライブラリルーチン7 
ライン 

2点間に〜を引く 576 
CP から578 
CP から相対で577 
〜スタイル538,588,608 
〜幅538,588,608 
〜八ターン538 
乱数発生ルーチン327.330 
〜の初期化331,397 
ランタイムライブラリ 
関数の分類13 

〜ソースコード10 

ランダムなブロック軎き出し329 
ランダムなブロック呼び出し328 
ランダム レコードフィールド 328,329 
リンクされたグラフ イ ックスドライハ • 589 


口ー テート（ビットの〜） 

unsigned int 339,340 
unsigned long 260 

ロック（ファイルシェアリング）254,453 

【ゎ】 

ヮード 

ハードウヱアポートからの 

1充み込み219 

ハードウ: L アボートへの 

拌き込み294 

ワイルドカード 

〜の展開23 

デフォルトで〜を行う24 
統合環境の場合24 
割り当て（メモリの〜 ） 51 
far ヒープ 128.130 
グラフィックスメモリ562 
データ セグメント での〜 69 
〜の変更341 
動的〜73,168 .266, 334 
ヒープ heap 73,168,266,334 
割り込み 

ソフトウ ヱア〜 184.221,223,228 

ハードウェァ〜 118 

〜を可能にする118 
〜を禁止する109 
割り込み関数 ( DOS ) 207,372 
割り込みの制御110,184 
割り込みハンドラ376 
DOS 〜213 
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割り込みベクタ 105 

8086 8086 の〜 207.372 
〜の設定372 
〜を 返す207 
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